Skip to content

docs: refresh PyPI install guidance#8

Merged
saagpatel merged 1 commit into
mainfrom
codex/pypi-docs-refresh
May 18, 2026
Merged

docs: refresh PyPI install guidance#8
saagpatel merged 1 commit into
mainfrom
codex/pypi-docs-refresh

Conversation

@saagpatel
Copy link
Copy Markdown
Owner

What

  • Makes PyPI the default public install path in README.
  • Updates distribution docs for active Trusted Publishing and same-tag release flow.
  • Updates distribution policy tests so stale "PyPI inactive" copy cannot return.

Why

  • github-repo-auditor is now published on PyPI, so the public README and PyPI long description need to tell the truth.

How

  • Replaces GitHub-source-first install copy with PyPI-first install commands.
  • Keeps GitHub Releases and source installs documented as secondary paths.

Testing

  • ruff check src/ tests/
  • python3 -m pytest tests/test_distribution_policy.py tests/test_versioning.py -q -p no:cacheprovider
  • python3 -m pytest -q -p no:cacheprovider

Performance Impact

  • None expected; docs/test-only change.

Risk / Notes

  • Follow-up release v0.1.3 is needed so PyPI displays the corrected README.

- make PyPI the default public install path
- document active Trusted Publishing release flow
- update distribution policy tests

Tests: ruff check src/ tests/; python3 -m pytest tests/test_distribution_policy.py tests/test_versioning.py -q -p no:cacheprovider; python3 -m pytest -q -p no:cacheprovider
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 44052562d0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread README.md

```bash
uv tool install 'git+https://github.com/saagpatel/GithubRepoAuditor.git#egg=github-repo-auditor[serve]'
pip install "github-repo-auditor[serve]"
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Document serve extras for isolated installs

When a user follows the recommended uv tool install or pipx install path above and later wants the web UI, this pip install command installs the [serve] extra into whatever Python environment pip targets, not into the already-created isolated tool environment. The audit executable from uv/pipx will still hit _run_serve_mode's missing-extra path unless the extra is installed into that tool environment, so the README should give a tool-aware reinstall/inject command for github-repo-auditor[serve] rather than plain pip install.

Useful? React with 👍 / 👎.

@saagpatel saagpatel merged commit de83c3b into main May 18, 2026
1 check passed
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.

1 participant