pathconf 1.0.9.4

Uses os.walk to find and catalogue a given file.

I do not recommend using this project as it was created for internal use. Due to this it is quite specific in how it works.

As stated in the short description this project simply uses os.walk to traverse a filesystem, starting in the users home directory, looking for a given file. It was created for internal use as there are several of us in the office running python scripts which are located on a onedrive and each time a new machine was initialised onedrive would have wildly different paths. Originally we were just using a simple function at the start of each script which would return the onedrive path but as different parts of the path started changing with new devices I realised this would quickly become an incredibly intricate and inneficient solution so I wrote this to help solve it. Published here for easier distribution around the office.

use:

import pathconf

pathconf.find_path('filename.filetype')

Alternatively you can give it a partial directory.

pathconf.find_path('folder/filename.filetype')

or

pathconf.find_path('foldera/folderb/filename.filetype')

If no filetype is specified and the folder param is not passed, eg:

pathconf.find_path('filename')	

Then the search will be done without taking file extension into account. If a file name has a . in it, like 'filename.filename.txt', it should still work. The workaround was to take the part after the . as an extension only if it is 5 characters or less. This however causes problems with files such as 'file.name.txt' as if you do not specify the extension .name will be taken as the extension instead. This issue exists only in the defining of the search term as when searching for files I just looked for a second . and split there.

This functionality is available but not recommended, you're better off just giving the extension.

Passing the optional 'folder=' parameter will search for a folder instead of a file.

pathconf.find_path('folderName', folder=True)

Passing the optional 'starting_dir=' parameter will change the starting directory from the users home directory.

pathconf.find_path('filename.filetype', starting_dir='C:\\')
# for windows

#or

pathconf.find_path('filename.filetype', starting_dir='/')
# for unix

Will start the search from the specified directory, in the example above this is the root directory.

This will create a .file_paths json file in home/.config/pathconf/ if it doesn't already exist and then will search for your file. Once found it will add that file to the pathconf file for quicker access in future runs. If the file does already exist it will lookup your desired file and if it exists in the pathconf.json it will then check that the file exists where stated. If the file exists where the pathconf.json says it does then it will use that file, if the file doesn't exist there or the file doesn't appear in the pathconf.json then it will search for the file and append it to the pathconf.json.

Have now added remove(), reset(), get_paths(), and list_paths().

pathconf.list_paths()

Will list all key and value pairs in the pathconf.json.

pathconf.get_paths()	

Will return a dictionary of paths held in the pathconf.json.

pathconf.reset()

Will reset the pathconf.json to a blank file.

pathconf.remove('filename.filetype')

Will remove the entry for filename.filetype from the pathconf.json.

Installation:

Easiest way to install is using pip

pip install pathconf

Current issues:

Haven't yet run into but understand that this will always take the first match it finds, if there are files with the same name and type elsewhere in your home directory then it will use them if found first, even if they're not the desired file. Will skip any directory whose name contains 'Deprecated' as an attempt to workaround for our usecase as most duplicate file names will be found in our Deprecated Scripts directory.