This package finds the root directory of a project by traversing the ancestors directories starting at a given path.
Project description
Root Folder Search
This package finds the root directory of a project by recursively traversing parent directories starting at a given path.
I used it to overcome a limitation in Jupyter Notebooks, that doesn't provide the __file__
variable that would let me easily find the root folder of a project, regardless the current working directory. You might find it useful in other scenarios.
How to use
import rootfoldersearch
# returns a string with the absolute path to the root folder, where Readme.md is located, starting the search in the CWD.
rootfoldersearch.findpath('Readme.md')
# the same, but using a file in a subfolder as reference to find the root directory
rootfoldersearch.findpath('/util/a-file')
# the same, but only tries 3 parent folders recursively (default is 10)
rootfoldersearch.findpath('Readme.md', depth=3)
# starting the search in a specific directory (as opposed to using the CWD)
rootfoldersearch.findpath('Readme.md', cwd='/..')
Project details
Release history Release notifications
Download files
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 rootfoldersearch-0.0.2-py3-none-any.whl (2.9 kB) | File type Wheel | Python version py3 | Upload date | Hashes View hashes |
Filename, size rootfoldersearch-0.0.2.tar.gz (1.7 kB) | File type Source | Python version None | Upload date | Hashes View hashes |
Close
Hashes for rootfoldersearch-0.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3da44c96d44f3431bb7f4479023c02c21b3cd62608ed09a400238ee5bc5b62fc |
|
MD5 | 7e4b685c47c7a605043553c39aacf1c9 |
|
BLAKE2-256 | 32acdbf88a001271ea0d41e0e3d5b08a5de401a5be3e29e13deb652379dc6fe4 |