Skip to main content

Get root directory based on file name

Project description

This package simply finds the root of a project based on a filename.

Usage

  1. Create a hidden file in the root directory of your project.
vim .my_hidden_root_file

Tip: Use project-specific name not a generic .root or even rely on .git. Get creative.

  1. Install groo
pip install groo-ozika

Tip: use conda and make sure to activate the right environment to install into.

  1. Import to your code and use
from groo.groo import get_root
root_folder = get_root(".my_hidden_root_file")

Tip: Always use os.path.join() to declare paths. It will make your code run across platforms and you won't get any strange erorrs (e.g., extra /).

Optional If you want to provide a time limit to the search for the root you can do so by using the timelim flag (in seconds).

root_folder = get_root(".my_hidden_root_file", timelim=10)

Example usage

Let's say that wee want to keep all project-related files in a specific folder (which can be anywhere on your computer). Let's call this project_folder.

Then, within it we want to have some data mydata.csv in a data folder and some scripts in a scripts folder runscript.py.

To let groo identify the root folder we need to create a file there. I usually prefer to use a dot file because it will remain hidden, however, it can be anything. In this example we will create .my_hidden_root_file in the project_folder.

Once the hidden file is created, one might want to load it in their python script (or a jupyter ntbk). Here we want to load data/mydata.csv within the scripts/runscript.py.

To do that, we can use this example:

from groo.groo import get_root
root_folder = get_root(".my_hidden_root_file")

import pandas as pd
df = pd.read_csv(os.path.join(root_folder, "data", "mydata.csv"))

Note that the same code will work for any script that is anywhere whithin the project_folder.

Enjoy!

Release Notes

New in version 0.1.0
1/ Fixed bug from 0.0.9
2/ Added verbose option, if verbose=True groo will print out the directories that it's searching

Added "quick search" which scans directories above in the hierarchy before performing a more comprehensive search.

New in version 0.0.9

Added "quick search" which scans directories above in the hierarchy before performing a more comprehensive search.

New in version 0.0.8

Removed bug which was displaying path.

New in version 0.0.7

  1. Previous versions of groo could only search for the root flag above in the directory hierarchy. Starting 0.0.7, the flag can be in theory anywhere on the computer. The search algorithm starts from the location of the file and on each iteration moves a level up, performs a full search.
  2. Since full search can sometimes be unpractical, groo now allows users to specify maximum time limit using the timelim flag get_root(".my_hidden_root_file", timelim=10).

Logo by AbtoCreative :heart:

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

groo-ozika-0.1.1.tar.gz (4.2 kB view details)

Uploaded Source

Built Distribution

groo_ozika-0.1.1-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file groo-ozika-0.1.1.tar.gz.

File metadata

  • Download URL: groo-ozika-0.1.1.tar.gz
  • Upload date:
  • Size: 4.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.5

File hashes

Hashes for groo-ozika-0.1.1.tar.gz
Algorithm Hash digest
SHA256 4f15bb956f8dcdfb0b77a77ec36dece82ca3300ca5f2ed4f71a18996609cfc61
MD5 10987eb60672bca03eaaaf255363dd6f
BLAKE2b-256 a90ee55074b376e0e169d1284dca7cc8be45874f0b372510c4318f88700318af

See more details on using hashes here.

File details

Details for the file groo_ozika-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: groo_ozika-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 5.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.5

File hashes

Hashes for groo_ozika-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3f0102aaf43cfdb2688a575006f3a8c4990fe0fd14f909b15bfd34fe5c2f9ae9
MD5 a05827c85872b56c0111c1ed75d41b2b
BLAKE2b-256 37195ec2c76af8580ff5fb59fa3455ab1f51edc7db313c7b65e8587b72a05bdf

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page