pkgcheck

Pre-publish packaging sanity scanner for Python packages.

twine check validates metadata syntax. It does not verify that your declared console scripts actually import and run. pkgcheck does — it builds your wheel and actually imports and invokes every entry point, so an ImportError or a broken CLI surfaces before you ship a broken sdist to PyPI.

Part of the Kryptorious developer tool fleet.

What it checks

The last four are the differentiator: pkgcheck builds a wheel into a temp dir and imports from it, so it catches publish-breaking bugs that static metadata checks miss.

Install

pip install kryptorious-pkgcheck

Usage

# Scan the current package (builds a wheel and tests entry points)
pkgcheck check

# Scan a specific path
pkgcheck check ./my-package

# Machine-readable output for CI — exits non-zero if not publish-ready
pkgcheck check --json

# Skip building a wheel (uses the installed/editable package instead)
pkgcheck check --no-build

# Probe README URLs over the network
pkgcheck check --check-links

In CI

- name: Packaging gate
  run: pkgcheck check --json

pkgcheck exits 0 only when the package is publish_ready (no errors, no blocking issues). Wire it as a required status check before your publish job.

Exit codes

• 0 — publish ready (or --json with zero blocking issues)
• 1 — not publish ready (errors present) or human report has errors
• 1 — CI JSON mode with blocking issues

License

MIT — see LICENSE.