-
Notifications
You must be signed in to change notification settings - Fork 870
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add PIP_COMPATIBILITY.md
to document known deviations from pip
#2244
Conversation
aea2331
to
881b35b
Compare
Still draft, missing one or two things, and need to adjust the README. |
881b35b
to
d37985a
Compare
Okay, ready for review. The goal here is for this to something we can link to when folks have questions about sub-items in the document. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
📜 📜 📜
``` | ||
|
||
When uv resolutions differ from `pip` in undesirable ways, it's often a sign that the specifiers | ||
are too loose, and that the user should consider tightening them. For example, in the case of |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'd make this more concrete: Please add >=
bounds to your packages.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Isn't this clear in the example?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice!
PIP_COMPATIBILITY.md
Outdated
dependency. | ||
|
||
In sum, uv needs to know upfront whether the resolver should accept pre-releases for a given | ||
package. `pip`, meanwhile, will generally respect pre-release identifiers in transitive |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
FYI, I expanded on this a bit here: #1641 (comment)
It's not important for uv, but certainly anything stronger than "generally" would be wrong, could even be "sometimes".
Anyway, this is great and reads well.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks!
d37985a
to
a1d2dce
Compare
Summary
Closes #2023.