ruffit 0.1.1

Monitor Python files and auto-run ruff, ty, and formatting checks on change. Fast, colorful, and easy CLI for code quality automation.

ruffit

A Python CLI tool for monitoring .py files and automatically running code quality checks and formatting.

Features

• Watches for changes to Python files in any folder you specify
• Debounces rapid file events to avoid duplicate triggers
• On modification, automatically runs:
  • ruff format to auto-format code
  • ruff check to lint and check for code issues
  • ty check to check type annotations
• Rich terminal output for clear, colorful feedback
• Flexible CLI: monitor any folder by name, or the whole project

Installation

pip install ruffit

Or, for local development:

pip install -e .

Usage

Monitor all Python files in the project:

ruffit all

Monitor only a specific folder (e.g., tests):

ruffit tests

If the folder does not exist, ruffit will print an error.

Development & Testing

• Tests are in the tests/ folder and use pytest.
• To install test dependencies:

  pip install .[test]
  

• To run tests:

  pytest
  

Contributing

Pull requests and issues are welcome!

License

MIT

Troubleshooting: Command Not Found

If you see an error like:

'ruffit' is not recognized as the name of a cmdlet, function, script file, or operable program.

This usually means the Python Scripts directory is not in your PATH, or you are not in the correct virtual environment.

• If you are using a virtual environment, make sure it is activated before installing and running ruffit:

  .venv\Scripts\Activate
  pip install ruffit
  ruffit
  

• If you still see the error, you can always run ruffit with:

  python -m ruffit
  

See the Python documentation for more on PATH and script locations.