Root-agnostic filepath generation
Project description
Purpose
The filepaths module is designed to ease file path navigation in python scripts.
Installation
python -m pip install filepaths
Use
from filepaths import paths
paths = paths(1)
for file in paths.data.filepaths():
pd.read_csv(file)
pass
or
from filepaths import Root
root = Root(1).paths()
for file in root.data.filepaths:
pd.read_csv(file)
pass
The root object builds a dictionary of files and directories starting in either the current directory, or depth
levels up. By default, hidden files and folder are ignored, but ignore_hidden
can be set to False
.
The .path()
method returns an addict dictionary. This dictionary inherits the standard dictionary class; it can be accessed with either root[data][files]
or root.data.files
.
Alternitavely, one can call the function paths()
with the same paramaters as the class Root
which will return a addict dictionary directly.
The keys 'files', 'dirs', 'path',
and 'filepaths'
are reserved for the dictionary: if there are directories with these names in any of the children directories, an error will be thrown.
Either Root
or paths
dictionary has a key for every directory in root. Every directory, including root
, has keys for 'files', 'dirs', 'path',
and 'filepaths'
. The values are either another nested dictionary for the dirs
, or:
root.example.path
returns the absolute path to theexample/
as a string.root.example.dirs
returns a list of the child directories inexample/
.root.example.files
returns a list of the filenames, as strings, for every file inexample/
.root.example.filepaths
returns a list of the absolute paths, as strings, to every file inexample/
.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for filepaths-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a8255b36a23c508bb538c8cf75ad488ec065b02f4852accd274e4ce91d914f11 |
|
MD5 | eb85c0e1d25cc557abbcc1650ff1abc7 |
|
BLAKE2b-256 | 4387c1124a24cf808aa90dfc8f47d6b33f234d6f6e83604c4d791ffbe22a73f4 |