powerwalk 0.5.0

Fast parallel directory walking for Python, powered by Rust

powerwalk

Fast parallel directory walking for Python, powered by Rust.

• Find the repo here.
• Read the docs here.

Features

• 🚀 Fast: Uses the rust ignore crate for fast directory traversal.
• ⚡ Parallel: Multi-threaded directory traversal.
• 🎯 Smart filtering: Built-in support for .gitignore, .ignore, and glob patterns.
• 🔒 Type-safe: Full type hints.

Installation

pip install powerwalk

Quick Start

import powerwalk

# Find all Python files, respecting .gitignore
for entry in powerwalk.walk(".", filter="**/*.py"):
    if entry.is_file:
        print(entry.path)

# Custom configuration with filtering and exclusion
for entry in powerwalk.walk(
    ".",
    filter=["**/*.yaml", "**/*.yml"],
    exclude=["**/node_modules", "**/__pycache__"],
    max_depth=3,
    threads=4,
):
    print(entry.path_str, entry.is_dir)