filepaths 0.0.1

Root-agnostic filepath generation

filepaths

Purpose

The filepaths module is designed to ease file path navigation in python scripts.

Use

from filepaths import Root

root = Root(depth=1).paths()

for file in root.data.files:
    pd.read_csv(file)

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.

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.

Here, root has a key for every directory in root. Every directory, including root, has keys for 'files', 'dirs', 'path', and 'filepaths'.

• root.example.path returns the absolute path to the example/ as a string.
• root.example.dirs returns a list of the child directories in example/.
• root.example.files returns a list of the filenames, as strings, for every file in example/.
• root.example.filepaths returns a list of the absolute paths, as strings, to every file in example/.