Package: pathier
pathierExtends the standard library pathlib.Path class.InstallationInstall with:pip install pathierUsageFunctions the same as pathlib.Path, but with added functions and some altered default arguments.NavigationNew paths can be obtained by:naming the parent with moveup()subtracting a number of levels from the current pathnaming the parent of the path you actually want with move_under()separating a relative path at a named parent with separate()set current working directory to path>>> from pathier import Pathier
>>> path = Pathier("C:/some/directory/to/some/file/on/the/system")
>>> path.moveup("directory")
WindowsPath('C:/some/directory')
>>> path - 3
WindowsPath('C:/some/directory/to/some/file')
>>> path.move_under("directory")
WindowsPath('C:/some/directory/to')
>>> path.separate("file")
WindowsPath('on/the/system')
>>> path.separate("file", True)
WindowsPath('file/on/the/system')
>>> path.mkcwd()
>>> Pathier.cwd()
WindowsPath('C:/some/directory/to/some/file/on/the/system')Environment PATH VariablePathier objects can be added and removed from sys.path:(The path will only be added if it isn't already in sys.path)>>> from pathier import Pathier
>>> path = Pathier.cwd()
>>> path.in_PATH
False
>>> path.add_to_PATH(0)
>>> path.in_PATH
True
>>> path.remove_from_PATH()
>>> path.in_PATH
False
>>> path.append_to_PATH()
>>> path.in_PATH
TrueRead and WriteCan dump and load toml, json, and pickle files without needed to explicityly import and call functions from the respective libraries:from pathier import Pathier
path = Pathier("some_file.toml")
content = path.loads()
path.with_suffix(".json").dumps(content, indent=2)Pathier().mkdir()creates parent directories and doesn't throw an error if the path already exists by default.Pathier().write_text()andPathier().write_bytes()will create parent directories by default if they won't exist.Pathier().write_text()will also try to cast the data to be written to a string if a TypeError is thrown.Pathier().delete()will delete a file or directory, event if that directory isn't empty.Pathier().copy()will copy a file or a directory tree to a new destination and return a Pathier object for the new pathBy default, files in the destination will not be overwritten.Pathier().backup()will create a copy of the path with_backupappended to the stem.
If the optional parameter,timestamp, isTrue, a datetime string will be added after_backupto prevent overwriting previous backup files.Pathier().replace_strings()takes a list of string pairs and will read the file the instance points to, replace the first of each pair with the second of each pair, and then write it back to the file.Essentially just condenses reading the file, using str.replace(), and then writing the new content into one function call.Pathier().execute()wraps callingos.system()on the path pointed to be thePathierinstance.Optional strings that should come before and after the path string can be specified with thecommandandargsparams, respectively.Pathier("file.py").execute("py", "--iterations 10")is equivalent toos.system("py file.py --iterations 10")Pathier().append()will append the given string to the file pointed at by the instance.Pathier().join(data)is equivalent to callingPathier().write_text("\n".join(data)).The joining string can be specified with thesepparameter.Pathier().split()is equivalent to callingPathier().read_text().splitlines().Optionally, line endings can be kept withPathier().split(keepends=True).Stats and Comparisons>>> from pathier import Pathier
>>> p = Pathier.cwd() / "pathier.py"
>>> i = p.parent / "__init__.py"
>>> p.dob
datetime.datetime(2023, 3, 31, 18, 43, 12, 360000)
>>> p.age
8846.024934
>>> p.mod_date
datetime.datetime(2023, 3, 31, 21, 7, 30)
>>> p.mod_delta
207.488857
>>> p.size
10744
>>> p.format_bytes(p.size)
'10.74 kb'
>>> p.formatted_size
'10.74 kb'
>>> p.is_larger(i)
True
>>> p.is_older(i)
False
>>> p.modified_more_recently(i)
TrueCLI ScriptsExecutesizeupfrom a terminal to get a grid of sub-directories and their sizes.P:\python\projects\pathier>sizeup
Sizing up 7 directories...
Scanning 'dist' [____________________________________________________________________________________________________________________________________________]-100.00%
+---------------+-----------+
| Dir           | Size      |
+===============+===========+
| docs          | 362.74 kb |
+---------------+-----------+
| tests         | 63.69 kb  |
+---------------+-----------+
| dist          | 61.78 kb  |
+---------------+-----------+
| src           | 50.91 kb  |
+---------------+-----------+
| .git          | 24.25 kb  |
+---------------+-----------+
| .pytest_cache | 540 bytes |
+---------------+-----------+
| .vscode       | 197 bytes |
+---------------+-----------+
Total size of 'P:\python\projects\pathier': 564.11 kb
sizeup average execution time: 37ms 895us