Skip to main content

PyPI version License: MIT Downloads LinkedIn

FolderScanner

FolderScanner is a Python package that enables efficient scanning of directory structures, applying ignore rules similar to .gitignore, and chunking file contents for processing. It's designed to handle large datasets and is ideal for pre-processing tasks in data analysis or machine learning pipelines.

Features

  • Recursively scans specified directories.
  • Applies ignore patterns to skip specified files and directories.
  • Chunks file contents and yields them with their paths for efficient processing.

Installation

To install FolderScanner, simply use pip:

pip install FolderScanner

Usage

Import and use FolderScanner in your Python projects as follows:

from folder_scanner import scan_directory

core_folder = '/path/to/your/projects'
ignore_patterns = ['.git', '.dockerignore', '*.log', 'tmp/*']

for file_chunk in scan_directory(core_folder, ignore_patterns):
    print(file_chunk)

Contributing

Contributions are welcome! Please feel free to submit pull requests, report bugs, or suggest features on the GitHub issues page.

License

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

Metadata

Release files for FolderScanner 2025.4.231612

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for FolderScanner 2025.4.231612
File Size Uploaded Provenance Actions
folderscanner-2025.4.231612.tar.gz 3.5 kB Without provenance Details for folderscanner-2025.4.231612.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for FolderScanner 2025.4.231612
File Interpreter ABI Platform Actions
folderscanner-2025.4.231612-py3-none-any.whl Python 3 none any Details for folderscanner-2025.4.231612-py3-none-any.whl

Total release size: 7.6 kB

Release files / folderscanner-2025.4.231612.tar.gz

Download URL folderscanner-2025.4.231612.tar.gz
Size 3.5 kB
Tags Source
SHA-256 checksum
How to use checksums
c2bfcde2639eebe018f8b64911f6d581f41f4ec1dcf0e97e1b52c24f741f6eec
BLAKE2b-256 checksum
How to use checksums
fdbe7bffbebb84be5290cf5b6845deafae5f0a9c1fea054557c0d23fb23aa797
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.11

Release files / folderscanner-2025.4.231612-py3-none-any.whl

Download URL folderscanner-2025.4.231612-py3-none-any.whl
Size 4.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
14c059e695a4fbf950e617b4d299ac0bb14dfa776b1f406020af4149de5ce752
BLAKE2b-256 checksum
How to use checksums
baadc0d258b8d8a3709aaa024fd7c600e0afbb3468209975e73293acf6470ef1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.11

Security for FolderScanner 2025.4.231612

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page