twisted.python.filepath.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 (e.g. "." 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.
Method changed Clear any cached information about the state of this path on disk.
Method getsize Retrieve the size of this file in bytes.
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 Check if this file path exists.
Method isdir Check if this file path refers to a directory.
Method isfile Check if this file path refers to a regular file.
Method children List the children of this path object.
Method basename Retrieve the final component of the file path's path (everything after the final path separator).
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.
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)

Retrieve the size of this file in bytes.

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)

Check if this file path exists.

ReturnsTrue if the file at this file path exists, False otherwise. (type: bool)
def isdir(): (source)

Check if this file path refers to a directory.

ReturnsTrue if the file at this file path is a directory, False otherwise.
def isfile(): (source)

Check if this file path refers to a regular file.

ReturnsTrue if the file at this file path is a regular file, False otherwise.
def children(): (source)

List the children of this path object.

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)

Retrieve the final component of the file path's path (everything after the final path separator).

Returnsthe base name of this file path. (type: str)
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 2020-03-20 23:54:06.