Skip to content

Improve PyPI/GitHub discoverability: keywords, classifiers, badges, py.typed#76

Open
aural-psynapse wants to merge 8 commits into
mainfrom
feat/pypi-discoverability
Open

Improve PyPI/GitHub discoverability: keywords, classifiers, badges, py.typed#76
aural-psynapse wants to merge 8 commits into
mainfrom
feat/pypi-discoverability

Conversation

@aural-psynapse

@aural-psynapse aural-psynapse commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Changes

  • Keywords: add ai-agents, llm, guardrails, llm-security, observability, hallucination.
  • Classifiers: add Development Status, Intended Audience, Topic (Security / HTTP / Monitoring / Libraries), Python :: 3 :: Only, Implementation :: CPython, Typing :: Typed. All strings verified against pypi.org/classifiers and accepted by a clean build.
  • py.typed: new PEP 561 marker so consumers' type-checkers get the shipped types. Makes the Typing :: Typed and mypy badge honest.
  • README badges: 5 live badges — CI, PyPI version, Python versions, License, Types-Mypy. Dropped the static status/coverage badges and stars/downloads.
  • bumpversion: drop the README hook (its v1.0.0 target was the removed status badge).

Why

Richer valid classifiers and search keywords improve PyPI findability; live badges stay accurate with no upkeep. Badge set follows what mature Python tools ship (httpx, ruff, pydantic): version/license/python/CI are the credible core, and low stars/downloads on a new package read as vanity, so they wait. SPDX license = "BUSL-1.1" (PEP 639) is left for a separate PR since it changes packaging metadata.

@aural-psynapse
aural-psynapse force-pushed the feat/pypi-discoverability branch from c8afbac to e47d780 Compare July 16, 2026 17:36
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md
Comment thread README.md
Comment thread pyproject.toml Outdated
@aural-psynapse aural-psynapse self-assigned this Jul 17, 2026
Comment thread README.md
Comment thread README.md Outdated
Comment thread README.md Outdated
SimoneBottoni
SimoneBottoni previously approved these changes Jul 17, 2026

@SimoneBottoni SimoneBottoni left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Comment thread README.md
Comment on lines 18 to 41
@@ -36,57 +39,23 @@ SourceryKit handles policy enforcement and logging right inside your agent's nor
- **Provably Backend**: The source of truth that turns your local intercepts into anchored verification proofs.


Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can even merge these two sections into a single "Features" section.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants