pycodetags-issue-tracker 0.2.0

Plugin for pycodetags to track issues, e.g. bugs, TODO, etc in your code

Issue Tracker

This is a PEP350 inspired issue tracker. Store issues in source code.

# 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

pip install pycodetags pycodetags-issue-tracker

pipa install pycodetags 
pipx inject pycodetags pycodetags-issue-tracker

Usage

Basic usage is to generate a TODO report and website.

.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 Rejected proposal, now implemented, mostly by pycodetags

Documentation

• Readthedocs