parameters: (self, path)
return_statement: return f
docstring: Helper to produce a directory listing (absent index.html).
  
          Return value is either a file object, or None (indicating an
          error).  In either case, the headers are sent, making the
          interface the same as for send_head().
docstring_summary: Helper to produce a directory listing (absent index.html).
docstring_tokens: Helper to produce a directory listing ( absent index . html ) .
function: def list_directory(self, path):
          """Helper to produce a directory listing (absent index.html).
  
          Return value is either a file object, or None (indicating an
          error).  In either case, the headers are sent, making the
          interface the same as for send_head().
  
          """
          try:
              list = os.listdir(path)
          except os.error:
              self.send_error(404, "No permission to list directory")
              return None
          list.sort(key=lambda a: a.lower())
          f = StringIO()
          displaypath = cgi.escape(urllib.unquote(self.path))
          f.write('<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">')
          f.write("<html>\n<title>Directory listing for %s</title>\n" % displaypath)
          f.write("<body>\n<h2>Directory listing for %s</h2>\n" % displaypath)
          f.write("<hr>\n<ul>\n")
          for name in list:
              fullname = os.path.join(path, name)
              displayname = linkname = name
              # Append / for directories or @ for symbolic links
              if os.path.isdir(fullname):
                  displayname = name + "/"
                  linkname = name + "/"
              if os.path.islink(fullname):
                  displayname = name + "@"
                  # Note: a link to a directory displays with @ and links with /
              f.write('<li><a href="%s">%s</a>\n'
                      % (urllib.quote(linkname), cgi.escape(displayname)))
          f.write("</ul>\n<hr>\n</body>\n</html>\n")
          length = f.tell()
          f.seek(0)
          self.send_response(200)
          encoding = sys.getfilesystemencoding()
          self.send_header("Content-type", "text/html; charset=%s" % encoding)
          self.send_header("Content-Length", str(length))
          self.end_headers()
          return f
function_tokens: def list_directory ( self , path ) : try : list = os . listdir ( path ) except os . error : self . send_error ( 404 , "No permission to list directory" ) return None list . sort ( key = lambda a : a . lower ( ) ) f = StringIO ( ) displaypath = cgi . escape ( urllib . unquote ( self . path ) ) f . write ( '<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">' ) f . write ( "<html>\n<title>Directory listing for %s</title>\n" % displaypath ) f . write ( "<body>\n<h2>Directory listing for %s</h2>\n" % displaypath ) f . write ( "<hr>\n<ul>\n" ) for name in list : fullname = os . path . join ( path , name ) displayname = linkname = name # Append / for directories or @ for symbolic links if os . path . isdir ( fullname ) : displayname = name + "/" linkname = name + "/" if os . path . islink ( fullname ) : displayname = name + "@" # Note: a link to a directory displays with @ and links with / f . write ( '<li><a href="%s">%s</a>\n' % ( urllib . quote ( linkname ) , cgi . escape ( displayname ) ) ) f . write ( "</ul>\n<hr>\n</body>\n</html>\n" ) length = f . tell ( ) f . seek ( 0 ) self . send_response ( 200 ) encoding = sys . getfilesystemencoding ( ) self . send_header ( "Content-type" , "text/html; charset=%s" % encoding ) self . send_header ( "Content-Length" , str ( length ) ) self . end_headers ( ) return f