code-annotations
Extensible tools for parsing annotations in codebases
Decision gist · record as of 2026-08-14
Yes, with conditions. Install if you need to parse and report on code annotations (especially PII detection) and are comfortable with Python 3.12+. The package is actively maintained, has no known vulnerabilities, and low install friction. However, its Alpha status suggests it may be best suited for teams already in the Open edX ecosystem or those willing to invest in customization via its plugin system.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later; earlier versions are not supported.
- Low friction install with stable maintenance.
- Active repository, recent release (154 days old), no known vulnerabilities.
License · maintenance · safety
Apache Software License 2.0 (permissive) — Apache Software License 2.0 is permissive; you can use, modify, and distribute this package freely in most contexts, including commercial work, provided you include the license notice.
last release 2026-03-13 (154 days) · last repo commit 2026-08-12 · 5 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 105,174 downloads/mo, #12,716 on PyPI
Alternatives
Verify before relying
pip install code-annotations
from code_annotations.base import AnnotationConfig
from code_annotations.extensions import AnnotationExtension
config = AnnotationConfig()
extension = AnnotationExtension(config)- Specific annotation types supported beyond PII (fact sheet mentions generalization but does not list concrete examples).
- Performance characteristics on large codebases (number of files, lines, or time complexity).
- Integration points with CI/CD systems or IDEs beyond Sphinx documentation.
- Whether the package is actively used in production or primarily experimental (Development Status :: 3 - Alpha).
- Typical adoption and usage patterns outside the Open edX ecosystem.
What it is and what it does
code-annotations is a framework for finding and cataloging annotations embedded in source code. Originally built to detect personally identifiable information (PII) markers in codebases, it provides configurable parsers and report generators that can be extended for other annotation types. The package ships with Sphinx extensions for documenting annotations and includes support for multi-line comments and feature-toggle annotations.
The tool is designed for teams that need to audit code for sensitive data, compliance markers, or other inline metadata. It depends on click, pyyaml, Jinja2, stevedore, and python-slugify for configuration, templating, and plugin loading. The package is actively maintained and supports Python 3.12+, though it carries an Alpha development status.
Use it for
- Scan a codebase for inline PII annotations and generate a compliance report.
- Build a custom annotation parser for feature-toggle markers and integrate it into your pipeline.
- Document code sections with Sphinx extensions that extract and render annotation metadata.
- Audit codebases for security-sensitive comments or deprecated API usage markers.
- Create a plugin via stevedore to detect custom annotation types in your organization's code.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with conditions.
Install if you need to parse and report on code annotations (especially PII detection) and are comfortable with Python 3.12+. The package is actively maintained, has no known vulnerabilities, and low install friction. However, its Alpha status suggests it may be best suited for teams already in the Open edX ecosystem or those willing to invest in customization via its plugin system.
Install
code-annotations on PyPI
Before you install
Low friction install with stable maintenance. Active repository, recent release (154 days old), no known vulnerabilities. Requires Python 3.12+; five runtime dependencies are all well-established.
Requires Python 3.12 or later; earlier versions are not supported.
License in practice
Apache Software License 2.0 is permissive; you can use, modify, and distribute this package freely in most contexts, including commercial work, provided you include the license notice.
Quickstart
pip install code-annotations
from code_annotations.base import AnnotationConfig
from code_annotations.extensions import AnnotationExtension
config = AnnotationConfig()
extension = AnnotationExtension(config)Verify before relying
- Specific annotation types supported beyond PII (fact sheet mentions generalization but does not list concrete examples).
- Performance characteristics on large codebases (number of files, lines, or time complexity).
- Integration points with CI/CD systems or IDEs beyond Sphinx documentation.
- Whether the package is actively used in production or primarily experimental (Development Status :: 3 - Alpha).
- Typical adoption and usage patterns outside the Open edX ecosystem.
Package facts
| License | Apache Software License 2.0 permissive |
| Python support | Supports the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesclickpyyamlJinja2stevedorepython-slugify |
| Maintenance | Actively maintained 154 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 105,174 / month, #12,716 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 3 - AlphaFramework :: DjangoFramework :: Django :: 4.2Framework :: Django :: 5.2Intended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseNatural Language :: EnglishProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.12 |
Evidence: code_annotations-3.0.0-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “code annotation parsing”
- code-annotationsParses and summarizes code annotations (originally for PII detection)…
- conlluParses CoNLL-U formatted text (a standard NLP annotation format) into…
- pycocotoolsProvides Python APIs for loading, parsing, and working with the…
Give your agent the search over MCP, or paste the wish link into any chat.
More Quality Assurance packages
Coverage.py measures which lines of Python code are executed during test runs, reporting coverage percentages and identifying untested code paths.
Install it if you want to measure test completeness or enforce coverage thresholds in your project.
Ruff is a Python linter and code formatter written in Rust that combines linting, formatting, and code fixing into a single tool, replacing Flake8, Black, isort, and related utilities.
Pexpect spawns and controls interactive console applications by sending input and matching output patterns, automating tasks that would otherwise require manual interaction.
Black reformats Python source code to a consistent style by parsing entire files and rewriting them according to an opinionated, deterministic set of rules, eliminating manual formatting decisions.
pytest-xdist distributes pytest tests across multiple CPU cores or machines to speed up test execution, with the simplest usage being `pytest -n auto` to spawn workers equal to available CPUs.
Install it if your test suite takes long enough that parallelization would save meaningful time.
Validates AWS CloudFormation templates in YAML or JSON format against resource provider schemas and best practices, checking property values and configuration correctness.
Install it if you work with CloudFormation templates.
See also autotyping · flake8-annotations-complexity · comment-parser · flake8-annotations · typing-inspection · rstcheck · pylint-django · tree-sitter-c-sharp · trailmark · dtlpymetrics