parameters: (path, recurse=True, includedot=False)
return_statement: return dobj
docstring: Gets a L{Directory} object representing the filesystem of the
      given path.
      @param path: base path to list
      @keyword recurse: recurse into subdirectories
      @keyword includedot: include '.' files
      @return: L{Directory} object instance
docstring_summary: Gets a L{Directory} object representing the filesystem of the
      given path.
      @param path: base path to list
      @keyword recurse: recurse into subdirectories
      @keyword includedot: include '.' files
      @return: L{Directory} object instance
docstring_tokens: Gets a L { Directory } object representing the filesystem of the given path . @param path : base path to list @keyword recurse : recurse into subdirectories @keyword includedot : include . files @return : L { Directory } object instance
function: def GetDirectoryObject(path, recurse=True, includedot=False):
      """Gets a L{Directory} object representing the filesystem of the
      given path.
      @param path: base path to list
      @keyword recurse: recurse into subdirectories
      @keyword includedot: include '.' files
      @return: L{Directory} object instance
  
      """
      assert os.path.isdir(path)
      def _BuildDir(thedir):
          dirAddFile = thedir.Files.append
          isdir = os.path.isdir
          pjoin = os.path.join
          for fname in os.listdir(thedir.Path):
              if not includedot and fname.startswith('.'):
                  continue
              fpath = pjoin(thedir.Path, fname)
              if isdir(fpath):
                  newobj = Directory(fpath)
                  if recurse:
                      _BuildDir(newobj)
              else:
                  newobj = File(fpath)
              dirAddFile(newobj)
  
      dobj = Directory(path)
      _BuildDir(dobj)
      return dobj
function_tokens: def GetDirectoryObject ( path , recurse = True , includedot = False ) : assert os . path . isdir ( path ) def _BuildDir ( thedir ) : dirAddFile = thedir . Files . append isdir = os . path . isdir pjoin = os . path . join for fname in os . listdir ( thedir . Path ) : if not includedot and fname . startswith ( '.' ) : continue fpath = pjoin ( thedir . Path , fname ) if isdir ( fpath ) : newobj = Directory ( fpath ) if recurse : _BuildDir ( newobj ) else : newobj = File ( fpath ) dirAddFile ( newobj ) dobj = Directory ( path ) _BuildDir ( dobj ) return dobj