# liverun
*A simple CLI tool to run commands on file changes.*
## Installation
```bash
pip install liverun
```
## Usage
```text
usage: liverun [-h] -f FILES [FILES ...] (-c COMMAND | -x EXEC_ARGV [EXEC_ARGV ...]) [-p POLL_INTERVAL] [--no-initial-run] [-v]
A simple CLI tool to run commands on file changes.
options:
-h, --help show this help message and exit
-f FILES [FILES ...], --files FILES [FILES ...]
One or more file paths to watch for changes.
-c COMMAND, --command COMMAND
Shell command to execute when a change is detected (runs in the platform shell).
-x EXEC_ARGV [EXEC_ARGV ...], --exec EXEC_ARGV [EXEC_ARGV ...]
Execute the given program/args directly (no shell). Example: --exec python -m pytest -q
-p POLL_INTERVAL, --poll-interval POLL_INTERVAL
Polling interval in seconds (default: 1.0).
--no-initial-run Do not run the action immediately at startup (default is to run once).
-v, --verbose Enable info-level logging output.
```
### Example
```bash
liverun -f deck.json deck.csv -c "decksmith build" -p 1.0 -v
```
Run the `decksmith build` shell command whenever any of the two files changes, check every second, be verbose.
Raw data
{
"_id": null,
"home_page": null,
"name": "liverun",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "file watcher, cli, devtools, livereload, python",
"author": "Julynx",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/2f/e0/fb983d74e195234096015b064c24a135e4757e85a250f2630e75d90849ff/liverun-0.1.1.tar.gz",
"platform": null,
"description": "# liverun\r\n\r\n*A simple CLI tool to run commands on file changes.*\r\n\r\n## Installation\r\n\r\n```bash\r\npip install liverun\r\n```\r\n\r\n## Usage\r\n\r\n```text\r\nusage: liverun [-h] -f FILES [FILES ...] (-c COMMAND | -x EXEC_ARGV [EXEC_ARGV ...]) [-p POLL_INTERVAL] [--no-initial-run] [-v]\r\n\r\nA simple CLI tool to run commands on file changes.\r\n\r\noptions:\r\n -h, --help show this help message and exit\r\n -f FILES [FILES ...], --files FILES [FILES ...]\r\n One or more file paths to watch for changes.\r\n -c COMMAND, --command COMMAND\r\n Shell command to execute when a change is detected (runs in the platform shell).\r\n -x EXEC_ARGV [EXEC_ARGV ...], --exec EXEC_ARGV [EXEC_ARGV ...]\r\n Execute the given program/args directly (no shell). Example: --exec python -m pytest -q\r\n -p POLL_INTERVAL, --poll-interval POLL_INTERVAL\r\n Polling interval in seconds (default: 1.0).\r\n --no-initial-run Do not run the action immediately at startup (default is to run once).\r\n -v, --verbose Enable info-level logging output.\r\n```\r\n\r\n### Example\r\n\r\n```bash\r\nliverun -f deck.json deck.csv -c \"decksmith build\" -p 1.0 -v\r\n```\r\n\r\nRun the `decksmith build` shell command whenever any of the two files changes, check every second, be verbose.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A simple CLI tool to run commands on file changes.",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/Julynx/liverun",
"Repository": "https://github.com/Julynx/liverun"
},
"split_keywords": [
"file watcher",
" cli",
" devtools",
" livereload",
" python"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3f6e7a943189fbea68a87feb865bfbd1bfe92aeafb6f70a5ff44531ee0536a68",
"md5": "7744b6b614e950bcc47f48212e743f33",
"sha256": "7e98c7a3dc1b44fcbec358bfa6d26129dcddca111d36968d73287fe23a3f35e6"
},
"downloads": -1,
"filename": "liverun-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7744b6b614e950bcc47f48212e743f33",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 6882,
"upload_time": "2025-08-06T22:36:00",
"upload_time_iso_8601": "2025-08-06T22:36:00.132541Z",
"url": "https://files.pythonhosted.org/packages/3f/6e/7a943189fbea68a87feb865bfbd1bfe92aeafb6f70a5ff44531ee0536a68/liverun-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2fe0fb983d74e195234096015b064c24a135e4757e85a250f2630e75d90849ff",
"md5": "94e06b465db5c888d9303ec21d238350",
"sha256": "66a1d786e5c9d38cfcb708124721d8126107295a29a151066fd8121159a3066e"
},
"downloads": -1,
"filename": "liverun-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "94e06b465db5c888d9303ec21d238350",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 6155,
"upload_time": "2025-08-06T22:36:01",
"upload_time_iso_8601": "2025-08-06T22:36:01.268286Z",
"url": "https://files.pythonhosted.org/packages/2f/e0/fb983d74e195234096015b064c24a135e4757e85a250f2630e75d90849ff/liverun-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-06 22:36:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Julynx",
"github_project": "liverun",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "liverun"
}
JSON
