py-fso 1.0.8

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.

Getting Started

Prerequisites

• python (version >=3+, version 2+ doesn’t check)

Installing

# Just install the package globally (recommended)
# so you can use in all your scripts and projects:
$ python -m pip install py_fso

Using

# 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][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)

Versioning

Using SemVer for versioning.

Authors

• Mikhail Trusov - py_fso

License

This project is licensed under the MIT License - see the LICENSE.md file for details