docs: point dependency_links deprecation page to modern direct URL dependencies - #5312
Open
CAOShurong wants to merge 1 commit into
Open
docs: point dependency_links deprecation page to modern direct URL dependencies#5312CAOShurong wants to merge 1 commit into
CAOShurong wants to merge 1 commit into
Conversation
…pendencies The dependency_links deprecation page warned that pip dropped support in 19.0 but gave readers no path forward. Add an explicit pointer to the PEP 508 direct-reference syntax and the 'Direct URL dependencies' section of the dependency management guide, and mark the rest of the page as historical. Fixes pypa#4859 Signed-off-by: Shurong Cao <170531907+CAOShurong@users.noreply.github.com>
Contributor
|
Tick the box to add this pull request to the merge queue (same as
|
Contributor
|
Also done in #5305 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #4859.
Summary
The dependency_links deprecation page warns that pip dropped support in 19.0 (2019), but then continues with ~80 lines of working-looking
setup()/setup.cfgrecipes without ever telling the reader what to do instead. This is exactly the confusion reported in #4859: a reader lands on this page needing "a link to a GitHub repo as a dependency" and leaves without a modern answer.Change
Docs-only, no code:
name @ URL) declared independencies, linking to the existing "Direct URL dependencies" section of the user guide (:doc:reference + section name;docs/conf.pydoes not enableautosectionlabel, so a bare section anchor:ref:is not available).Verification
:pep:/:doc:resolve; no new warnings).docs/userguide/dependency_management.rstL212 ("Direct URL dependencies") and documents bothgit+https://...and wheel-URL forms.