t.p.f.IFilePath(Interface) : interface documentation

Part of twisted.python.filepath View Source View In Hierarchy

Known implementations: twisted.python.filepath.FilePath, twisted.python.zippath.ZipPath

File path object.

A file path represents a location for a file-like-object and can be organized into a hierarchy; a file path can can children which are themselves file paths.

A file path has a name which unique identifies it in the context of its parent (if it has one); a file path can not have two children with the same name. This name is referred to as the file path's "base name".

A series of such names can be used to locate nested children of a file path; such a series is referred to as the child's "path", relative to the parent. In this case, each name in the path is referred to as a "path segment"; the child's base name is the segment in the path.

When representing a file path as a string, a "path separator" is used to delimit the path segments within the string. For a file system path, that would be os.sep.

Note that the values of child names may be restricted. For example, a file system path will not allow the use of the path separator in a name, and certain names (eg. "." and "..") may be reserved or have special meanings.

Present Since12.1
Attribute sep The path separator to use in string representations
Method child Obtain a direct child of this file path. The child may or may not exist.
Method open Opens this file path with the given mode. @return: a file-like-object. @raise Exception: if this file path cannot be opened.
Method changed Clear any cached information about the state of this path on disk.
Method getsize
Method getModificationTime Retrieve the time of last access from this file.
Method getStatusChangeTime Retrieve the time of the last status change for this file.
Method getAccessTime Retrieve the time that this file was last accessed.
Method exists
Method isdir
Method isfile
Method children
Method basename
Method parent A file path for the directory containing the file at this file path.
Method sibling A file path for the directory containing the file at this file path. @param name: the name of a sibling of this path. name must be a direct sibling of this path and may not contain a path separator.
sep =
The path separator to use in string representations
def child(name): (source)
Obtain a direct child of this file path. The child may or may not exist.
Parametersnamethe name of a child of this path. name must be a direct child of this path and may not contain a path separator.
Returnsthe child of this path with the given name.
RaisesInsecurePathif name describes a file path that is not a direct child of this file path.
def open(mode='r'): (source)
Opens this file path with the given mode.
Returnsa file-like-object.
RaisesExceptionif this file path cannot be opened.
def changed(): (source)
Clear any cached information about the state of this path on disk.
def getsize(): (source)
Returnsthe size of the file at this file path in bytes.
RaisesExceptionif the size cannot be obtained.
def getModificationTime(): (source)
Retrieve the time of last access from this file.
Returnsa number of seconds from the epoch. (type: float)
def getStatusChangeTime(): (source)
Retrieve the time of the last status change for this file.
Returnsa number of seconds from the epoch. (type: float)
def getAccessTime(): (source)
Retrieve the time that this file was last accessed.
Returnsa number of seconds from the epoch. (type: float)
def exists(): (source)
ReturnsTrue if the file at this file path exists, False otherwise.
def isdir(): (source)
ReturnsTrue if the file at this file path is a directory, False otherwise.
def isfile(): (source)
ReturnsTrue if the file at this file path is a regular file, False otherwise.
def children(): (source)
Returnsa sequence of the children of the directory at this file path.
RaisesExceptionif the file at this file path is not a directory.
def basename(): (source)
Returnsthe base name of this file path.
def parent(): (source)
A file path for the directory containing the file at this file path.
def sibling(name): (source)
A file path for the directory containing the file at this file path.
Parametersnamethe name of a sibling of this path. name must be a direct sibling of this path and may not contain a path separator.
Returnsa sibling file path of this one.
API Documentation for Twisted, generated by pydoctor at 2012-09-01 11:44:56.