# duty
[![ci](https://github.com/pawamoy/duty/workflows/ci/badge.svg)](https://github.com/pawamoy/duty/actions?query=workflow%3Aci)
[![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/duty/)
[![pypi version](https://img.shields.io/pypi/v/duty.svg)](https://pypi.org/project/duty/)
[![gitter](https://badges.gitter.im/join%20chat.svg)](https://app.gitter.im/#/room/#duty:gitter.im)
A simple task runner.
Inspired by [Invoke](https://github.com/pyinvoke/invoke).
![demo](demo.svg)
## Installation
```bash
pip install duty
```
With [`uv`](https://docs.astral.sh/uv/):
```bash
uv tool install duty
```
## Quick start
Create a `duties.py` file at the root of your repository.
```python
from duty import duty
@duty
def docs(ctx):
ctx.run("mkdocs build", title="Building documentation")
```
You can now use the command line tool to run it:
```bash
duty docs
```
See the [Usage](https://pawamoy.github.io/duty/usage/)
section in the documentation for more examples.
Also see ["Why choosing duty over..."](https://pawamoy.github.io/duty/#why-duty-over).
Raw data
{
"_id": null,
"home_page": null,
"name": "duty",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "task-runner, task, runner, cross-platform",
"author": null,
"author_email": "=?utf-8?q?Timoth=C3=A9e_Mazzucotelli?= <dev@pawamoy.fr>",
"download_url": "https://files.pythonhosted.org/packages/3e/72/8f2bd5bde1796283b10217c71dbaec5b0b2d02e4348f6c299858a280154d/duty-1.4.3.tar.gz",
"platform": null,
"description": "# duty\n\n[![ci](https://github.com/pawamoy/duty/workflows/ci/badge.svg)](https://github.com/pawamoy/duty/actions?query=workflow%3Aci)\n[![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/duty/)\n[![pypi version](https://img.shields.io/pypi/v/duty.svg)](https://pypi.org/project/duty/)\n[![gitter](https://badges.gitter.im/join%20chat.svg)](https://app.gitter.im/#/room/#duty:gitter.im)\n\nA simple task runner.\n\nInspired by [Invoke](https://github.com/pyinvoke/invoke).\n\n![demo](demo.svg)\n\n## Installation\n\n```bash\npip install duty\n```\n\nWith [`uv`](https://docs.astral.sh/uv/):\n\n```bash\nuv tool install duty\n```\n\n## Quick start\n\nCreate a `duties.py` file at the root of your repository.\n\n```python\nfrom duty import duty\n\n@duty\ndef docs(ctx):\n ctx.run(\"mkdocs build\", title=\"Building documentation\")\n```\n\nYou can now use the command line tool to run it:\n\n```bash\nduty docs\n```\n\nSee the [Usage](https://pawamoy.github.io/duty/usage/)\nsection in the documentation for more examples.\n\nAlso see [\"Why choosing duty over...\"](https://pawamoy.github.io/duty/#why-duty-over).\n",
"bugtrack_url": null,
"license": "ISC",
"summary": "A simple task runner.",
"version": "1.4.3",
"project_urls": {
"Changelog": "https://pawamoy.github.io/duty/changelog",
"Discussions": "https://github.com/pawamoy/duty/discussions",
"Documentation": "https://pawamoy.github.io/duty",
"Funding": "https://github.com/sponsors/pawamoy",
"Gitter": "https://gitter.im/duty/community",
"Homepage": "https://pawamoy.github.io/duty",
"Issues": "https://github.com/pawamoy/duty/issues",
"Repository": "https://github.com/pawamoy/duty"
},
"split_keywords": [
"task-runner",
" task",
" runner",
" cross-platform"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "de9785ec7ee0dc82c30988b5726e5ced3d13fb48010de96d8c653265102ab528",
"md5": "ac2909d506aeb8dfcf2fffb4f325e1e9",
"sha256": "84094a5df227fcaf158c90e00d13b16e3cfb45e53c789f32e858e2e514ab3244"
},
"downloads": -1,
"filename": "duty-1.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ac2909d506aeb8dfcf2fffb4f325e1e9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 105116,
"upload_time": "2024-10-17T15:17:53",
"upload_time_iso_8601": "2024-10-17T15:17:53.511649Z",
"url": "https://files.pythonhosted.org/packages/de/97/85ec7ee0dc82c30988b5726e5ced3d13fb48010de96d8c653265102ab528/duty-1.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3e728f2bd5bde1796283b10217c71dbaec5b0b2d02e4348f6c299858a280154d",
"md5": "1106d7ae502f8647401da6015299bfdd",
"sha256": "92f3955b6d0ce3779b7389daf7f1de5d0cd603fbf56983480b568baedf90edff"
},
"downloads": -1,
"filename": "duty-1.4.3.tar.gz",
"has_sig": false,
"md5_digest": "1106d7ae502f8647401da6015299bfdd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 121780,
"upload_time": "2024-10-17T15:17:55",
"upload_time_iso_8601": "2024-10-17T15:17:55.314004Z",
"url": "https://files.pythonhosted.org/packages/3e/72/8f2bd5bde1796283b10217c71dbaec5b0b2d02e4348f6c299858a280154d/duty-1.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-17 15:17:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pawamoy",
"github_project": "duty",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "duty"
}