Skip to main content

Root-agnostic filepath generation

Project description

Purpose

The filepaths module is designed to ease file path navigation in python scripts. It is particularly useful for iterating through many files in a directory.

Use

Installation

pip install filepaths

Example

from filepaths import Root


paths = Root(__file__).paths()

for csv in paths.data.filepaths:
    pd.read_csv(csv)

Options

file=None: for default behavior pass in __file__
depth=0: how many levels up up from __file__ to start the walk down
ignore_hidden=True: whether or not to include hidden files/paths
alt_path=False: if desired, specify an absolute path to another directory instead of file=__file__

Description

The Root object stores information to build the strings for the desired directories and paths. The paths() method returns a nested dictionary of files, directories and the paths to them as values to the keys. If needed, paths() can be called again to return an updated dictionary.

The .paths() 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 of the dictionary are the names of the directories below the root directory, as well as ['files', 'dirs', 'path', filepaths'].

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.

The values to the mentioned keys are as follows:

  • 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/.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

filepaths-0.0.8.tar.gz (2.8 kB view hashes)

Uploaded source

Built Distribution

filepaths-0.0.8-py3-none-any.whl (3.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page