{"id":37085289,"url":"https://github.com/kevinjosethomas/py-mon","last_synced_at":"2026-01-14T10:29:04.744Z","repository":{"id":37784911,"uuid":"323435724","full_name":"kevinjosethomas/py-mon","owner":"kevinjosethomas","description":"🔁 Automatically restart application when file changes are detected; made for development","archived":false,"fork":false,"pushed_at":"2025-12-10T22:04:02.000Z","size":51,"stargazers_count":79,"open_issues_count":2,"forks_count":17,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-12-11T08:53:01.048Z","etag":null,"topics":["automated-testing","developer-tools","development","package","pypi","python","testing"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/py-mon/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kevinjosethomas.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-12-21T20:01:12.000Z","updated_at":"2025-12-10T22:04:07.000Z","dependencies_parsed_at":"2024-01-13T02:22:29.124Z","dependency_job_id":"5a3891b2-e2b5-46a0-aef1-cbfdda631331","html_url":"https://github.com/kevinjosethomas/py-mon","commit_stats":null,"previous_names":["trustedmercury/py-mon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kevinjosethomas/py-mon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjosethomas%2Fpy-mon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjosethomas%2Fpy-mon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjosethomas%2Fpy-mon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjosethomas%2Fpy-mon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevinjosethomas","download_url":"https://codeload.github.com/kevinjosethomas/py-mon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjosethomas%2Fpy-mon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28417274,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T10:25:19.714Z","status":"ssl_error","status_checked_at":"2026-01-14T10:22:49.371Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automated-testing","developer-tools","development","package","pypi","python","testing"],"created_at":"2026-01-14T10:29:04.249Z","updated_at":"2026-01-14T10:29:04.740Z","avatar_url":"https://github.com/kevinjosethomas.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# py-mon [![](https://img.shields.io/pypi/v/py-mon?color=3776AB\u0026logo=python\u0026style=for-the-badge)](https://pypi.org/project/py-mon/) [![](https://img.shields.io/pypi/dm/py-mon?color=3776AB\u0026logo=python\u0026style=for-the-badge)](https://pypi.org/project/py-mon/)\nA modern, easy-to-use package to automatically restart a Python application when file changes are detected!\n\n## Quickstart (10s)\n```bash\npip install -U py-mon\npymon app.py\n```\nZero-config reloads for Python files by default.\n\n### Why py-mon?\n- Works for Python files or any shell command (`-x \"npm run dev\"`).\n- Simple patterns for watch/ignore; sane defaults.\n- Clean/quiet mode available when you don’t want prompts.\n\n### Core flags\n- `-w / --watch \u003cpattern\u003e`: what to watch (default `*.py`).\n- `-i / --ignore \u003cpattern\u003e`: what to ignore.\n- `-x / --exec`: run a shell command instead of `python \u003cfile\u003e`.\n- `-d / --debug`: print changed paths.\n- `-c / --clean`: no logs, no stdin commands.\n\n### Command Input\nWhen running pymon, you can use these commands:\n- Type `rs` to manually restart the process\n- Type `stop` to terminate pymon\n\n### Optional Config File\nPut a `.pymonrc` or `pymon.json` in your project root to keep team settings consistent:\n\n```json\n{\n  \"watch\": [\"*.py\", \"config/*.yaml\"],\n  \"ignore\": [\"*__pycache__*\", \"*.log\"],\n  \"debug\": false,\n  \"clean\": false,\n  \"exec\": false,\n  \"delay\": 250\n}\n```\n\nCommand line arguments will always override config file settings.\n\nAnyway that's basically it! Thanks for everything, I would appreciate it if you could leave a follow or star this repository ❣️ If you have any feature requests, read below!\n\n## Contributing\nThis package is open source so anyone with adequate Python experience can contribute to this project!\n\n### Report Issues\nIf you find any issues with the package or in the code, please [create an issue and report it here](https://github.com/kevinjosethomas/py-mon/issues)!\n\n### Fix/Edit Content\nIf you want to contribute to this package, fork the repository, clone it, make your changes and then [proceed to create a pull request here](https://github.com/kevinjosethomas/py-mon/pulls)\n\n### Tests\nRun the test suite locally with pytest:\n```\npip install -e \".[dev]\"\npytest\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinjosethomas%2Fpy-mon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinjosethomas%2Fpy-mon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinjosethomas%2Fpy-mon/lists"}