py-fso 1.0.8

Description:

pyfso 1.0.8

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