README.md

findfile - simplified solution of FileNotFoundError

This is a package for you to locate your target file(s)/dir(s) easily.

Usage

Install

pip install findfile

ready to go (V2)

from findfile import FileManager

if __name__ == "__main__":

    # create a FileManager to index your files in the directory
    fm = FileManager(
        r"word_dir"
    )
    
    txt_files = fm.find_cwd_files(key=".txt", use_regex=False, recursive=30)

    lines = fm.readlines()  # read all lines in the files
    
    png_files = fm.find_cwd_files(key=".png")
    
    print(txt_files)

ready to use (V1)

If you have been bothered by FileNotFoundError while the file does exist but misplaced, you can call

from findfile import find_file, find_files, find_dir, find_dirs

search_path = './'

key = ['target', '.txt']  # str or list, the files whose absolute path contain all the keys in the key are the target files

exclude_key = ['dev', '.ignore']  # str or list, the files whose absolute path contain any exclude key are ignored

target_file = find_file(search_path, key, exclude_key, recursive=False)   # return the first target file, recursive means to search in all subdirectories

target_files = find_files(search_path, key, exclude_key, recursive=True)   # return all the target files, only the first param are required

target_dir = find_dir(search_path, key, exclude_key)  # search directory instead of file

target_dirs = find_dirs(search_path, key, exclude_key)  # search directories