‘filesysobjects.netfiles’ - Module¶
The ‘NetFiles’ module provides basic extensions for ‘os.path.normpath’.
Warning
This module is currently an experimental release for discussion and may change. Do not use it in production code!
The following subset of URLs / RFC...
Functions¶
net_normpathx¶
filesysobjects.netfiles.
net_normpathx
(path, **kargs)[source]¶Extends ‘os.path.normpathx’ for network filesystems applications.
Warning
This module is currently an experimental release for discussion and may change. Do not use it in production code!
The basic extension is the split of the full application level pathname into it’s application parts and the actual pathname of the node. The pathname of the node is still passed onto the call ‘os.path.normpath’, with a few exceptions only, whereas the network application part, and/or eventual protocol key of the URI are handled separately.
Thus the behavior for the filesystem address - the local path almost remains, while is extended by a network portion.
But due to the eventual different remote filesystem attributes the local evaluation remains unsafe, while else requires remote access for assurance of the parameters.
- Args:
- plist: List of paths to be cleared.
See common options for details.
default := sys.path
- **kargs:
- fstype: The type of the final target filesystem.
This is required because a remote filesystem could be ‘s.th.’ completely different, e.g. just a virtual representation of anything.
default := <local-filesystem-type>
- raw: Suppress of the call of ‘os.path.normpath’ and
- the generic term ‘share’.
- Returns:
- When successful returns the split file pathname, else returns either ‘None’, or raises an exception.
- Raises:
- passed through exceptions:
Resources¶
- For syntax design requirements refer to “Extended Filesystems - Network Features”.
- See also Python issue:
- Issue 26329: os.path.normpath(“//”) returns // - http://bugs.python.org/issue26329