This library is for you if you are also annoyed that there is no mutable pathlib wrapper for use cases where paths are often changed. mutapath solves this by wrapping the extended pathlib library path.py and updating the encapsulated object every time the path might be changed.
mutapath also adds the possibility to delimit file and path modifications to a safe fallback context.
The MutaPath Class allows direct manipulation of its attributes at any time, just as any mutable object. Once a file operation is called that is intended to modify its path, the underlying path is also mutated.
>>> from mutapath import MutaPath
>>> folder = MutaPath("/home/joe/doe/folder/sub") >>> folder Path('/home/joe/doe/folder/sub')
>>> folder.name = "top" >>> folder Path('/home/joe/doe/folder/top')
>>> next = MutaPath("/home/joe/doe/folder/next") >>> next Path('/home/joe/doe/folder/next')
>>> next.rename(folder) >>> next Path('/home/joe/doe/folder/top') >>> next.exists() True >>> Path('/home/joe/doe/folder/sub').exists() False
This class is immutable by default, just as the
pathlib.Path. However, it allows to open a editing context via
Moreover, there are additional contexts for file operations. They update the file and its path while closing the context.
If the file operations don't succeed, they throw an exception and fall back to the original path value.
>>> from mutapath import Path
>>> folder = Path("/home/joe/doe/folder/sub") >>> folder Path('/home/joe/doe/folder/sub')
>>> folder.name = "top" AttributeError: mutapath.Path is an immutable class, unless mutate() context is used. >>> folder Path('/home/joe/doe/folder/sub')
>>> with folder.mutate() as m: ... m.name = "top" >>> folder Path('/home/joe/doe/folder/top')
>>> next = Path("/home/joe/doe/folder/next") >>> next.copy(folder) >>> next Path('/home/joe/doe/folder/next') >>> folder.exists() True >>> folder.remove()
>>> with next.renaming() as m: ... m.stem = folder.stem ... m.suffix = ".txt" >>> next Path("/home/joe/doe/folder/sub.txt") >>> next.exists() True >>> next.with_name("next").exists() False
For more in-depth examples, check the tests folder.
mutapath paths are hashable by caching the generated hash the first time it is accessed. However, it also adds a warning so that unintended hash usage is avoided. Once mutated after that, the generated hashes don't provide collision detection in binary trees anymore. Don't use them in sets or as keys in dicts. Use the explicit string representation instead, to make the hashing input transparent.
>>> p = Path("/home") >>> hash(p) 1083235232 >>> hash(Path("/home")) == hash(p) True >>> with p.mutate() as m: ... m.name = "home4" >>> hash(p) # same hash 1083235232 >>> hash(Path("/home")) == hash(p) # they are not equal anymore True
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size mutapath-0.11.2-py3-none-any.whl (17.8 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size mutapath-0.11.2.tar.gz (13.7 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for mutapath-0.11.2-py3-none-any.whl