pip-audit-html 0.1.4

Convert pip-audit JSON reports into readable HTML reports

pip-audit-html

Convert pip-audit JSON output into a standalone, readable HTML report.

Why this package

• Easy CLI for local use and CI pipelines
• No runtime dependencies
• Generates a single HTML file you can archive or share

Installation

From PyPI (after publish):

pip install pip-audit-html

From source during development:

pip install -e .[dev]

CLI usage

Generate a report from file:

pip-audit-html pip-audit-report.json -o reports/security-report.html

Pipe input from stdin:

pip-audit --format json | pip-audit-html - -o reports/security-report.html

Set custom title and fail build if vulnerabilities exist:

pip-audit-html pip-audit-report.json -o report.html --title "Weekly Dependency Security" --fail-on-vulns

Default footer attribution is included in generated reports. You can override it if needed:

pip-audit-html pip-audit-report.json -o report.html --author-name "Your Name" --author-url "https://www.linkedin.com/in/your-profile/"

Hide specific vulnerabilities (IDs/CVEs) from rendered HTML output:

pip-audit-html pip-audit-report.json -o report.html --ignore-vuln PYSEC-2024-10 --ignore-vuln CVE-2024-12345

You can also pass comma-separated values:

pip-audit-html pip-audit-report.json -o report.html --ignore-vuln "PYSEC-2024-10,CVE-2024-12345"

You can also run it as a module:

python -m pip_audit_html pip-audit-report.json -o report.html

Local development

Use existing helper scripts:

1. Create environment (001_env.bat or 001_env.sh)
2. Activate environment (002_activate.bat or 002_activate.sh)
3. Install package/dev deps (003_setup.bat or 003_setup.sh)
4. Run CLI help (004_run.bat or 004_run.sh)
5. Run tests (005_run_test.bat or 005_run_test.sh)

Publish to PyPI

1. Update version in pyproject.toml.
2. Build distributions:

python -m pip install --upgrade build twine
python -m build

3. Validate artifacts:

python -m twine check dist/*

4. Upload:

python -m twine upload dist/*