powerwalk 0.6.0

Fast parallel directory walking for Python, powered by Rust

██████╗  ██████╗ ██╗    ██╗███████╗██████╗ ██╗    ██╗ █████╗ ██╗     ██╗  ██╗
██╔══██╗██╔═══██╗██║    ██║██╔════╝██╔══██╗██║    ██║██╔══██╗██║     ██║ ██╔╝
██████╔╝██║   ██║██║ █╗ ██║█████╗  ██████╔╝██║ █╗ ██║███████║██║     █████╔╝
██╔═══╝ ██║   ██║██║███╗██║██╔══╝  ██╔══██╗██║███╗██║██╔══██║██║     ██╔═██╗
██║     ╚██████╔╝╚███╔███╔╝███████╗██║  ██║╚███╔███╔╝██║  ██║███████╗██║  ██╗
╚═╝      ╚═════╝  ╚══╝╚══╝ ╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝

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 (errors ignored by default)
for entry in powerwalk.walk(".", filter="**/*.py"):
    if entry.is_file:
        print(entry.path)

# Handle errors during traversal
for result in powerwalk.walk(".", filter="**/*.py", ignore_errors=False):
    match result:
        case powerwalk.DirEntry():
            print(result.path)
        case powerwalk.Error():
            print(f"Error at {result.path}: {result.message}")

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