Auto-reload your Python app when source files change. Useful for development of web servers, CLI tools, or any script-driven workflow.
- Watches for changes in
.pyfiles - Automatically restarts your app
- Logs the exact file that triggered the restart
- Configurable via CLI or JSON file
- Cross-platform support
pip install PythonDevRunnergit clone https://github.com/mrjulesfletcher/PythonDevRunner.git
cd PythonDevRunner
pip install .devrunner --entry main.py --watch-ext .py --exclude venv __pycache__ --debounce 0.5devrunner --config examples/config.json| Option | CLI Flag | Config Key | Default |
|---|---|---|---|
| Entry script | --entry |
entry |
main.py |
| Extensions | --watch-ext |
watch_ext |
[".py"] |
| Exclude | --exclude |
exclude |
[] |
| Debounce | --debounce |
debounce |
0.5 |
| Verbose | --quiet |
quiet |
false |
[Watcher] File changed: /myproject/chat_panel.py
[Runner] Restart triggered by: /myproject/chat_panel.py
[Runner] Launching main.py
Supports installation via pip install . or from PyPI.
MIT
Created with ❤️ by Jules Le Masson
github.com/mrjulesfletcher