Skip to content

docs: point install at the repo — envars2 is not on PyPI - #19

Closed
kthhrv wants to merge 1 commit into
masterfrom
fix/readme-install
Closed

docs: point install at the repo — envars2 is not on PyPI#19
kthhrv wants to merge 1 commit into
masterfrom
fix/readme-install

Conversation

@kthhrv

@kthhrv kthhrv commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

pip install envars currently installs an unrelated third-party package (envars 0.3.5, a different project) because this package isn't published on PyPI — and the README's PyPI badge 404s for the same reason.

  • README and docs/getting-started.md now install via pip install git+https://github.com/timeoutdigital/envars2.git
  • Broken PyPI badge removed (restore it if/when the package is published — note the envars name is taken on PyPI, so publishing needs a rename or the envars2 name the badge already pointed at)

'pip install envars' installs an unrelated third-party package
(envars 0.3.5 from PyPI); this project is not published there, so the
PyPI badge 404s too. Point install at the GitHub repo and drop the
badge until the package is actually published.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings August 21, 2026 11:07
@kthhrv kthhrv closed this Aug 21, 2026

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Code Review

This pull request updates the installation instructions in README.md and docs/getting-started.md to install the package directly from the GitHub repository instead of PyPI. The review feedback suggests using the explicit PEP 508 direct reference syntax (pip install "envars @ git+...") to avoid ambiguity and assist the dependency resolver, since the package name (envars) differs from the repository name (envars2).

Comment thread README.md

```bash
pip install envars
pip install git+https://github.com/timeoutdigital/envars2.git

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

Since the package name (envars) differs from the repository name (envars2), it is recommended to use the explicit PEP 508 direct reference syntax. This makes it clear to pip and the user which package is being installed, and helps the dependency resolver.

Suggested change
pip install git+https://github.com/timeoutdigital/envars2.git
pip install "envars @ git+https://github.com/timeoutdigital/envars2.git"

Comment thread docs/getting-started.md

```bash
pip install envars
pip install git+https://github.com/timeoutdigital/envars2.git

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

Since the package name (envars) differs from the repository name (envars2), using the explicit PEP 508 direct reference syntax is recommended to avoid ambiguity for pip and the user.

Suggested change
pip install git+https://github.com/timeoutdigital/envars2.git
pip install "envars @ git+https://github.com/timeoutdigital/envars2.git"

@kthhrv
kthhrv deleted the fix/readme-install branch August 21, 2026 11:08

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Updates installation guidance to avoid pip install envars pulling an unrelated third-party PyPI project, aligning docs with the fact that this repository’s package is not currently published on PyPI.

Changes:

  • Removed the broken PyPI badge from README.md.
  • Updated install instructions in README.md and docs/getting-started.md to install from the GitHub repository URL.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
README.md Removes PyPI badge and updates installation command to install from GitHub.
docs/getting-started.md Updates getting-started installation command to install from GitHub.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread README.md

```bash
pip install envars
pip install git+https://github.com/timeoutdigital/envars2.git
Comment thread docs/getting-started.md

```bash
pip install envars
pip install git+https://github.com/timeoutdigital/envars2.git
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