The Python package for working with dirs and files
The main function of this small package is to process the contents of a folder with a single function: folder.process() (pun intended :-), without going into the details of iterating over files and folders.
It’s strange that python doesn’t have such a built-in function, but maybe someone (maybe even myself) will write an extension to c someday.
So, if, for example, you need to find all files with a too long full name, you just need to write the following script:
from argparse import ArgumentParser from py_fso import folder MAX_FILEPATH_LENGTH = 260 def print_if_file_has_length_too_more_chars(fileEntry) : filePath = fileEntry.path fileLength = len(filePath) if fileLength > MAX_FILEPATH_LENGTH: print("File " + filePath + " has length " + str(fileLength) + " chars") parser = ArgumentParser(description='Scan a directory and its subdirectories and search for files with path lengths greater than ' + str(MAX_FILEPATH_LENGTH) + ' characters.') parser.add_argument("directory", help="scan this directory with its subdirectories", metavar="DIR") parser.add_argument("-m", "--max_filepath_length", help="max file path's length") args = parser.parse_args() if args.max_filepath_length: MAX_FILEPATH_LENGTH = int(args.max_filepath_length) folder.process(init_dir = args.directory, proc_file_function = print_if_file_has_length_too_more_chars, process_dirs = False, proc_dir_function = '', go_into_subdirs = True)
Just one call to folder.process() will replace all the details of traversing the contents of the folder, allowing you to focus on the main action of the script.
The package also includes several useful functions for working with text files.
I use this package all the time in my work, installing it globally so that it’s available to all scripts. It’s very convenient.
python (version >=3+, version 2+ doesn’t check)
# Just install the package globally (recommended) # so you can use in all your scripts and projects: $ python -m pip install py_fso
# then you can use it in your scripts from py_fso import folder from py_fso import textfile
One more script example
#!/usr/bin/python # -*- coding: utf-8 -*- """ Try to find all files in the folder of a site including sub-folders which are not UTF-8 encoded.""" import chardet import os.path from py_fso import folder fileListExtensions = ["htm", "html", "php", "css", "js"] def print_if_file_code_page_not_utf8(fileEntry) : filePath = fileEntry.path if os.path.splitext(filePath)[1:].strip().lower() in fileListExtensions: with open(filePath, "rb") as F: text = F.read() enc = chardet.detect(text).get("encoding") if enc and enc.lower() != "utf-8": print("File " + filePath + " might not be UTF-8 encoded") folder.process("path\\to\\your\\site\\folder", proc_file_function = print_if_file_code_page_not_utf8, process_dirs = False, proc_dir_function = None, go_into_subdirs = True)
Using SemVer for versioning.
This project is licensed under the MIT License - see the LICENSE.md file for details
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.