Metadata-Version: 2.4
Name: pyscan-yb
Version: 0.1.6
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
License-File: LICENSE
Summary: A fast Python file scanner written in Rust
Keywords: file-scanner,python,rust,pyo3,cli
Author: Vaibhaw
License-Expression: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://ybhaw.github.io/pyscan-yb/
Project-URL: Homepage, https://github.com/ybhaw/pyscan-yb
Project-URL: Issues, https://github.com/ybhaw/pyscan-yb/issues
Project-URL: Repository, https://github.com/ybhaw/pyscan-yb

# pyscan-yb

[![PyPI version](https://img.shields.io/pypi/v/pyscan-yb)](https://pypi.org/project/pyscan-yb/)
[![CI](https://img.shields.io/github/actions/workflow/status/ybhaw/pyscan-yb/ci.yml?branch=main&label=CI)](https://github.com/ybhaw/pyscan-yb/actions)
[![Python versions](https://img.shields.io/pypi/pyversions/pyscan-yb)](https://pypi.org/project/pyscan-yb/)
[![License](https://img.shields.io/github/license/ybhaw/pyscan-yb)](https://github.com/ybhaw/pyscan-yb/blob/main/LICENSE)

A fast Python file scanner written in Rust.

Recursively finds all `.py` files in a directory, excluding system files and common non-source directories.

## Install

```bash
pip install pyscan-yb
```

For development:

```bash
pip install maturin
maturin develop
```

## Usage

### CLI

```bash
# Scan current directory
pyscan-yb

# Scan a specific path
pyscan-yb /path/to/project

# Quiet mode (paths only)
pyscan-yb -q /path/to/project
```

### Python API

```python
from pyscan_yb import scan

files = scan(".")
for f in files:
    print(f)
```

## Excluded Directories

`__pycache__`, `.git`, `.hg`, `.svn`, `.venv`, `venv`, `.tox`, `.mypy_cache`, `.pytest_cache`, `.egg-info`, `node_modules`

## Documentation

- [Wiki](https://github.com/ybhaw/pyscan-yb/wiki) — API reference, CLI usage, and more
- [Docs Site](https://ybhaw.github.io/pyscan-yb/) — Full documentation on GitHub Pages

## Contributing

See the [Contributing Guide](https://github.com/ybhaw/pyscan-yb/wiki/Contributing) for dev setup, testing, and PR guidelines.

## License

MIT

