This class is used to store information about a file or directory on
the file system.
They are stored out to the cache, so *never* store transient
information on them without clearing it through clear_transient.
Never construct these with File(). Use get_file_info, parse_file, or
parse_files instead. That guarantees that there is only one File instance
for each file in the filesystem.
| Method Summary |
| |
__init__(self,
normpath)
Normpath *must* be absolute and have been returned from
os.path.normpath. |
| |
__repr__(self)
|
| |
__str__(self)
Return the name of the file as a relative path from the current
working directory. |
| |
clear_transient(self)
Clear any transient attributes that were saved to the cache |
| |
dirname(self)
Return the File object that represents the directory that this File
resides in. |
| |
extract_uncommon_components(self,
files)
|
| |
file_contains(self,
contains,
compiled_contains)
Does the file contain the regexp 'contains'. |
| |
flush_mtime(self)
Flush the cache used in mtime() |
| |
get_includes(self,
include_path)
Given an include path (as a tuple of Files), return the Files that
this file includes. |
| |
get_java_package(self)
Get the java package for the file. |
| |
mtime(self)
Return the files modification time. |
| |
relative_to(self,
file)
Return the pathname for the file as a relative path from 'path' |
| |
remove(self)
Remove the file from the filesystem |
| |
set_includes(self,
include_path,
includes)
Sets the value that is retrieved by get_includes. |
| |
set_java_package(self,
package)
Set the java package for this file. |
| |
subdir(self,
name)
Return a File object that represents the given sub-directory of this
one. |