home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 June / PCWorld_2005-06_cd.bin / software / vyzkuste / firewally / firewally.exe / framework-2.3.exe / CGIHTTPServer.py < prev    next >
Text File  |  2003-12-30  |  11KB  |  328 lines
  1. """CGI-savvy HTTP Server.
  2.  
  3. This module builds on SimpleHTTPServer by implementing GET and POST
  4. requests to cgi-bin scripts.
  5.  
  6. If the os.fork() function is not present (e.g. on Windows),
  7. os.popen2() is used as a fallback, with slightly altered semantics; if
  8. that function is not present either (e.g. on Macintosh), only Python
  9. scripts are supported, and they are executed by the current process.
  10.  
  11. In all cases, the implementation is intentionally naive -- all
  12. requests are executed sychronously.
  13.  
  14. SECURITY WARNING: DON'T USE THIS CODE UNLESS YOU ARE INSIDE A FIREWALL
  15. -- it may execute arbitrary Python code or external programs.
  16.  
  17. """
  18.  
  19.  
  20. __version__ = "0.4"
  21.  
  22. __all__ = ["CGIHTTPRequestHandler"]
  23.  
  24. import os
  25. import sys
  26. import urllib
  27. import BaseHTTPServer
  28. import SimpleHTTPServer
  29. import select
  30.  
  31.  
  32. class CGIHTTPRequestHandler(SimpleHTTPServer.SimpleHTTPRequestHandler):
  33.  
  34.     """Complete HTTP server with GET, HEAD and POST commands.
  35.  
  36.     GET and HEAD also support running CGI scripts.
  37.  
  38.     The POST command is *only* implemented for CGI scripts.
  39.  
  40.     """
  41.  
  42.     # Determine platform specifics
  43.     have_fork = hasattr(os, 'fork')
  44.     have_popen2 = hasattr(os, 'popen2')
  45.     have_popen3 = hasattr(os, 'popen3')
  46.  
  47.     # Make rfile unbuffered -- we need to read one line and then pass
  48.     # the rest to a subprocess, so we can't use buffered input.
  49.     rbufsize = 0
  50.  
  51.     def do_POST(self):
  52.         """Serve a POST request.
  53.  
  54.         This is only implemented for CGI scripts.
  55.  
  56.         """
  57.  
  58.         if self.is_cgi():
  59.             self.run_cgi()
  60.         else:
  61.             self.send_error(501, "Can only POST to CGI scripts")
  62.  
  63.     def send_head(self):
  64.         """Version of send_head that support CGI scripts"""
  65.         if self.is_cgi():
  66.             return self.run_cgi()
  67.         else:
  68.             return SimpleHTTPServer.SimpleHTTPRequestHandler.send_head(self)
  69.  
  70.     def is_cgi(self):
  71.         """Test whether self.path corresponds to a CGI script.
  72.  
  73.         Return a tuple (dir, rest) if self.path requires running a
  74.         CGI script, None if not.  Note that rest begins with a
  75.         slash if it is not empty.
  76.  
  77.         The default implementation tests whether the path
  78.         begins with one of the strings in the list
  79.         self.cgi_directories (and the next character is a '/'
  80.         or the end of the string).
  81.  
  82.         """
  83.  
  84.         path = self.path
  85.  
  86.         for x in self.cgi_directories:
  87.             i = len(x)
  88.             if path[:i] == x and (not path[i:] or path[i] == '/'):
  89.                 self.cgi_info = path[:i], path[i+1:]
  90.                 return True
  91.         return False
  92.  
  93.     cgi_directories = ['/cgi-bin', '/htbin']
  94.  
  95.     def is_executable(self, path):
  96.         """Test whether argument path is an executable file."""
  97.         return executable(path)
  98.  
  99.     def is_python(self, path):
  100.         """Test whether argument path is a Python script."""
  101.         head, tail = os.path.splitext(path)
  102.         return tail.lower() in (".py", ".pyw")
  103.  
  104.     def run_cgi(self):
  105.         """Execute a CGI script."""
  106.         dir, rest = self.cgi_info
  107.         i = rest.rfind('?')
  108.         if i >= 0:
  109.             rest, query = rest[:i], rest[i+1:]
  110.         else:
  111.             query = ''
  112.         i = rest.find('/')
  113.         if i >= 0:
  114.             script, rest = rest[:i], rest[i:]
  115.         else:
  116.             script, rest = rest, ''
  117.         scriptname = dir + '/' + script
  118.         scriptfile = self.translate_path(scriptname)
  119.         if not os.path.exists(scriptfile):
  120.             self.send_error(404, "No such CGI script (%s)" % `scriptname`)
  121.             return
  122.         if not os.path.isfile(scriptfile):
  123.             self.send_error(403, "CGI script is not a plain file (%s)" %
  124.                             `scriptname`)
  125.             return
  126.         ispy = self.is_python(scriptname)
  127.         if not ispy:
  128.             if not (self.have_fork or self.have_popen2 or self.have_popen3):
  129.                 self.send_error(403, "CGI script is not a Python script (%s)" %
  130.                                 `scriptname`)
  131.                 return
  132.             if not self.is_executable(scriptfile):
  133.                 self.send_error(403, "CGI script is not executable (%s)" %
  134.                                 `scriptname`)
  135.                 return
  136.  
  137.         # Reference: http://hoohoo.ncsa.uiuc.edu/cgi/env.html
  138.         # XXX Much of the following could be prepared ahead of time!
  139.         env = {}
  140.         env['SERVER_SOFTWARE'] = self.version_string()
  141.         env['SERVER_NAME'] = self.server.server_name
  142.         env['GATEWAY_INTERFACE'] = 'CGI/1.1'
  143.         env['SERVER_PROTOCOL'] = self.protocol_version
  144.         env['SERVER_PORT'] = str(self.server.server_port)
  145.         env['REQUEST_METHOD'] = self.command
  146.         uqrest = urllib.unquote(rest)
  147.         env['PATH_INFO'] = uqrest
  148.         env['PATH_TRANSLATED'] = self.translate_path(uqrest)
  149.         env['SCRIPT_NAME'] = scriptname
  150.         if query:
  151.             env['QUERY_STRING'] = query
  152.         host = self.address_string()
  153.         if host != self.client_address[0]:
  154.             env['REMOTE_HOST'] = host
  155.         env['REMOTE_ADDR'] = self.client_address[0]
  156.         # XXX AUTH_TYPE
  157.         # XXX REMOTE_USER
  158.         # XXX REMOTE_IDENT
  159.         if self.headers.typeheader is None:
  160.             env['CONTENT_TYPE'] = self.headers.type
  161.         else:
  162.             env['CONTENT_TYPE'] = self.headers.typeheader
  163.         length = self.headers.getheader('content-length')
  164.         if length:
  165.             env['CONTENT_LENGTH'] = length
  166.         accept = []
  167.         for line in self.headers.getallmatchingheaders('accept'):
  168.             if line[:1] in "\t\n\r ":
  169.                 accept.append(line.strip())
  170.             else:
  171.                 accept = accept + line[7:].split(',')
  172.         env['HTTP_ACCEPT'] = ','.join(accept)
  173.         ua = self.headers.getheader('user-agent')
  174.         if ua:
  175.             env['HTTP_USER_AGENT'] = ua
  176.         co = filter(None, self.headers.getheaders('cookie'))
  177.         if co:
  178.             env['HTTP_COOKIE'] = ', '.join(co)
  179.         # XXX Other HTTP_* headers
  180.         if not self.have_fork:
  181.             # Since we're setting the env in the parent, provide empty
  182.             # values to override previously set values
  183.             for k in ('QUERY_STRING', 'REMOTE_HOST', 'CONTENT_LENGTH',
  184.                       'HTTP_USER_AGENT', 'HTTP_COOKIE'):
  185.                 env.setdefault(k, "")
  186.         os.environ.update(env)
  187.  
  188.         self.send_response(200, "Script output follows")
  189.  
  190.         decoded_query = query.replace('+', ' ')
  191.  
  192.         if self.have_fork:
  193.             # Unix -- fork as we should
  194.             args = [script]
  195.             if '=' not in decoded_query:
  196.                 args.append(decoded_query)
  197.             nobody = nobody_uid()
  198.             self.wfile.flush() # Always flush before forking
  199.             pid = os.fork()
  200.             if pid != 0:
  201.                 # Parent
  202.                 pid, sts = os.waitpid(pid, 0)
  203.                 # throw away additional data [see bug #427345]
  204.                 while select.select([self.rfile], [], [], 0)[0]:
  205.                     if not self.rfile.read(1):
  206.                         break
  207.                 if sts:
  208.                     self.log_error("CGI script exit status %#x", sts)
  209.                 return
  210.             # Child
  211.             try:
  212.                 try:
  213.                     os.setuid(nobody)
  214.                 except os.error:
  215.                     pass
  216.                 os.dup2(self.rfile.fileno(), 0)
  217.                 os.dup2(self.wfile.fileno(), 1)
  218.                 os.execve(scriptfile, args, os.environ)
  219.             except:
  220.                 self.server.handle_error(self.request, self.client_address)
  221.                 os._exit(127)
  222.  
  223.         elif self.have_popen2 or self.have_popen3:
  224.             # Windows -- use popen2 or popen3 to create a subprocess
  225.             import shutil
  226.             if self.have_popen3:
  227.                 popenx = os.popen3
  228.             else:
  229.                 popenx = os.popen2
  230.             cmdline = scriptfile
  231.             if self.is_python(scriptfile):
  232.                 interp = sys.executable
  233.                 if interp.lower().endswith("w.exe"):
  234.                     # On Windows, use python.exe, not pythonw.exe
  235.                     interp = interp[:-5] + interp[-4:]
  236.                 cmdline = "%s -u %s" % (interp, cmdline)
  237.             if '=' not in query and '"' not in query:
  238.                 cmdline = '%s "%s"' % (cmdline, query)
  239.             self.log_message("command: %s", cmdline)
  240.             try:
  241.                 nbytes = int(length)
  242.             except (TypeError, ValueError):
  243.                 nbytes = 0
  244.             files = popenx(cmdline, 'b')
  245.             fi = files[0]
  246.             fo = files[1]
  247.             if self.have_popen3:
  248.                 fe = files[2]
  249.             if self.command.lower() == "post" and nbytes > 0:
  250.                 data = self.rfile.read(nbytes)
  251.                 fi.write(data)
  252.             # throw away additional data [see bug #427345]
  253.             while select.select([self.rfile._sock], [], [], 0)[0]:
  254.                 if not self.rfile._sock.recv(1):
  255.                     break
  256.             fi.close()
  257.             shutil.copyfileobj(fo, self.wfile)
  258.             if self.have_popen3:
  259.                 errors = fe.read()
  260.                 fe.close()
  261.                 if errors:
  262.                     self.log_error('%s', errors)
  263.             sts = fo.close()
  264.             if sts:
  265.                 self.log_error("CGI script exit status %#x", sts)
  266.             else:
  267.                 self.log_message("CGI script exited OK")
  268.  
  269.         else:
  270.             # Other O.S. -- execute script in this process
  271.             save_argv = sys.argv
  272.             save_stdin = sys.stdin
  273.             save_stdout = sys.stdout
  274.             save_stderr = sys.stderr
  275.             try:
  276.                 try:
  277.                     sys.argv = [scriptfile]
  278.                     if '=' not in decoded_query:
  279.                         sys.argv.append(decoded_query)
  280.                     sys.stdout = self.wfile
  281.                     sys.stdin = self.rfile
  282.                     execfile(scriptfile, {"__name__": "__main__"})
  283.                 finally:
  284.                     sys.argv = save_argv
  285.                     sys.stdin = save_stdin
  286.                     sys.stdout = save_stdout
  287.                     sys.stderr = save_stderr
  288.             except SystemExit, sts:
  289.                 self.log_error("CGI script exit status %s", str(sts))
  290.             else:
  291.                 self.log_message("CGI script exited OK")
  292.  
  293.  
  294. nobody = None
  295.  
  296. def nobody_uid():
  297.     """Internal routine to get nobody's uid"""
  298.     global nobody
  299.     if nobody:
  300.         return nobody
  301.     try:
  302.         import pwd
  303.     except ImportError:
  304.         return -1
  305.     try:
  306.         nobody = pwd.getpwnam('nobody')[2]
  307.     except KeyError:
  308.         nobody = 1 + max(map(lambda x: x[2], pwd.getpwall()))
  309.     return nobody
  310.  
  311.  
  312. def executable(path):
  313.     """Test for executable file."""
  314.     try:
  315.         st = os.stat(path)
  316.     except os.error:
  317.         return False
  318.     return st.st_mode & 0111 != 0
  319.  
  320.  
  321. def test(HandlerClass = CGIHTTPRequestHandler,
  322.          ServerClass = BaseHTTPServer.HTTPServer):
  323.     SimpleHTTPServer.test(HandlerClass, ServerClass)
  324.  
  325.  
  326. if __name__ == '__main__':
  327.     test()
  328.