Skip to main content

The Python package for working with dirs and files

Project description

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


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 =, 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


  • 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

# -*- 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 =
            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 file for details

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

py_fso-1.0.8-py3-none-any.whl (6.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page