# Issue Tracker
This is a PEP350 inspired issue tracker. Store issues in source code.
```python
# TODO: Fix this code <matth 2025-07-05 category=math priority=high release=2.01>
```
Also supports advanced scenarios with TODOs as Objects, Decorators, etc.
## Installation
```bash
pip install pycodetags pycodetags-issue-tracker
```
```bash
pipa install pycodetags
pipx inject pycodetags pycodetags-issue-tracker
```
## Usage
Basic usage is to generate a TODO report and website.
```makefile
.PHONY: issues
issues:install_plugins
@echo "Checking issues"
$(VENV) pycodetags data --src pycodetags --src plugins --format json>issues_site/data.json
@echo "Current issues:"
$(VENV) pycodetags issues --src pycodetags --src plugins --format text
@echo "For best results, fix these issues:"
$(VENV) pycodetags issues --src pycodetags --src plugins --format validate
@echo "Generating HTML report"
$(VENV) pycodetags issues --src pycodetags --src plugins --format html>issues_site/index.html
```
## Prior Art
PEPs and Standard Library Prior Art
- [PEP 350 - Code Tags](https://peps.python.org/pep-0350/) Rejected proposal, now implemented, mostly by `pycodetags`
## Documentation
- [Readthedocs](https://pycodetags.readthedocs.io/en/latest/)
Raw data
{
"_id": null,
"home_page": null,
"name": "pycodetags-issue-tracker",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "FIXME, TODO, code-tag, code-tags, codetag, codetags, pep-350, pep350, pycodetags",
"author": null,
"author_email": "Matthew Martin <matthewdeanmartin@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/2a/0e/91a8ac9461e09fc5946ebb44ed63c2f1626355f323bd408c98c9f224185a/pycodetags_issue_tracker-0.3.0.tar.gz",
"platform": null,
"description": "# Issue Tracker\n\nThis is a PEP350 inspired issue tracker. Store issues in source code.\n\n```python\n# TODO: Fix this code <matth 2025-07-05 category=math priority=high release=2.01>\n```\n\nAlso supports advanced scenarios with TODOs as Objects, Decorators, etc.\n\n## Installation\n\n```bash\npip install pycodetags pycodetags-issue-tracker\n```\n\n```bash\npipa install pycodetags \npipx inject pycodetags pycodetags-issue-tracker\n```\n\n## Usage\n\nBasic usage is to generate a TODO report and website.\n\n```makefile\n.PHONY: issues\nissues:install_plugins\n\t@echo \"Checking issues\"\n\t$(VENV)\tpycodetags data --src pycodetags --src plugins --format json>issues_site/data.json\n\t@echo \"Current issues:\"\n\t$(VENV) pycodetags issues --src pycodetags --src plugins --format text\n\t@echo \"For best results, fix these issues:\"\n\t$(VENV) pycodetags issues --src pycodetags --src plugins --format validate\n\t@echo \"Generating HTML report\"\n\t$(VENV) pycodetags issues --src pycodetags --src plugins --format html>issues_site/index.html\n```\n\n## Prior Art\n\nPEPs and Standard Library Prior Art\n\n- [PEP 350 - Code Tags](https://peps.python.org/pep-0350/) Rejected proposal, now implemented, mostly by `pycodetags`\n\n## Documentation\n\n- [Readthedocs](https://pycodetags.readthedocs.io/en/latest/)",
"bugtrack_url": null,
"license": null,
"summary": "Plugin for pycodetags to track issues, e.g. bugs, TODO, etc in your code",
"version": "0.3.0",
"project_urls": null,
"split_keywords": [
"fixme",
" todo",
" code-tag",
" code-tags",
" codetag",
" codetags",
" pep-350",
" pep350",
" pycodetags"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3a04a1a02e9ea0dce93a302dc9c9a7cf9a33a6db5e34a021e37cd568e99b9cb9",
"md5": "deb774a6a76b1baf197d7e77f38a1e5a",
"sha256": "863d025359fb3cb2150d6f813b137340dd63f0f2422c157dc2d2a9a0f22d2731"
},
"downloads": -1,
"filename": "pycodetags_issue_tracker-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "deb774a6a76b1baf197d7e77f38a1e5a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 30146,
"upload_time": "2025-07-13T17:05:31",
"upload_time_iso_8601": "2025-07-13T17:05:31.927367Z",
"url": "https://files.pythonhosted.org/packages/3a/04/a1a02e9ea0dce93a302dc9c9a7cf9a33a6db5e34a021e37cd568e99b9cb9/pycodetags_issue_tracker-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2a0e91a8ac9461e09fc5946ebb44ed63c2f1626355f323bd408c98c9f224185a",
"md5": "f271d8d8c46a52b64e4f7a778bd10e55",
"sha256": "41d8852b8f9708809ed4f891608dd84776f47579bbe08c3fd91584239c939bee"
},
"downloads": -1,
"filename": "pycodetags_issue_tracker-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "f271d8d8c46a52b64e4f7a778bd10e55",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 49232,
"upload_time": "2025-07-13T17:05:33",
"upload_time_iso_8601": "2025-07-13T17:05:33.686857Z",
"url": "https://files.pythonhosted.org/packages/2a/0e/91a8ac9461e09fc5946ebb44ed63c2f1626355f323bd408c98c9f224185a/pycodetags_issue_tracker-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-13 17:05:33",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pycodetags-issue-tracker"
}
JSON