twisted.python.filepath module documentation

Part of twisted.python

Object-oriented filesystem path representation.

Interface IFilePath File path object.
Class InsecurePath Error that is raised when the path provided to FilePath is invalid.
Class LinkError An error with symlinks - either that there are cyclical symlinks or that symlink are not supported on this platform.
Class UnlistableError An exception which is used to distinguish between errors which mean 'this is not a directory you can list' and other, more catastrophic errors.
Class AbstractFilePath Abstract implementation of an IFilePath; must be completed by a subclass.
Class RWX A class representing read/write/execute permissions for a single user category (i.e. user/owner, group, or other/world). Instantiate with three boolean values: readable? writable? executable?.
Class Permissions A class representing read/write/execute permissions. Instantiate with any portion of the file's mode that includes the permission bits.
Class FilePath I am a path on the filesystem that only permits 'downwards' access.
Function _stub_islink Always return False if the operating system does not support symlinks.
Class _WindowsUnlistableError This exception is raised on Windows, for compatibility with previous releases of FilePath where unportable programs may have done "except WindowsError:" around a call to children().
Function _secureEnoughString Compute a string usable as a new, temporary filename.
Class _SpecialNoValue An object that represents 'no value', to be used in deprecating statinfo.
Function _asFilesystemBytes Return path as a string of bytes suitable for use on this system's filesystem.
Function _asFilesystemText Return path as a string of unicode suitable for use on this system's filesystem.
Function _coerceToFilesystemEncoding Return a newpath that is suitable for joining to path.
def _stub_islink(path):

Always return False if the operating system does not support symlinks.

ParameterspathA path string. (type: str)
ReturnsFalse (type: bool)
def _secureEnoughString(path):

Compute a string usable as a new, temporary filename.

ParameterspathThe path that the new temporary filename should be able to be concatenated with.
ReturnsA pseudorandom, 16 byte string for use in secure filenames. (type: the type of path)
def _asFilesystemBytes(path, encoding=None):

Return path as a string of bytes suitable for use on this system's filesystem.

ParameterspathThe path to be made suitable. (type: bytes or unicode)
encodingThe encoding to use if coercing to bytes. If none is given, sys.getfilesystemencoding is used.
Returnsbytes
def _asFilesystemText(path, encoding=None):

Return path as a string of unicode suitable for use on this system's filesystem.

ParameterspathThe path to be made suitable. (type: bytes or unicode)
encodingThe encoding to use if coercing to unicode. If none is given, sys.getfilesystemencoding is used.
Returnsunicode
def _coerceToFilesystemEncoding(path, newpath, encoding=None):

Return a newpath that is suitable for joining to path.

ParameterspathThe path that it should be suitable for joining to.
newpathThe new portion of the path to be coerced if needed.
encodingIf coerced, the encoding that will be used.
API Documentation for twisted, generated by pydoctor at 2020-03-25 17:34:30.