-
Notifications
You must be signed in to change notification settings - Fork 26
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
docs: add small note about version pinning #25
Conversation
Signed-off-by: David Caro <david@dcaro.es>
@@ -30,6 +30,16 @@ User's Guide | |||
This part of the documentation will show you how to get started in using | |||
inspire-schemas. | |||
|
|||
**NOTE**: is highly encouraged to pin the version of inspire-schemas that you |
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.
it is highly...
@@ -30,6 +30,16 @@ User's Guide | |||
This part of the documentation will show you how to get started in using | |||
inspire-schemas. | |||
|
|||
**NOTE**: is highly encouraged to pin the version of inspire-schemas that you | |||
use to the major number, for example using the `~=` version matcher in your | |||
`requires.txt` or your `setup.py` like:: |
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.
requirements.txt
.
inspire-schemas~=1.1.0 | ||
|
||
That will prevent any major update (compatibility breaking) to be pulled | ||
automatically, and will only download minor and feature updates (1.X.Y). |
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.
Not according to PEP 440: https://www.python.org/dev/peps/pep-0440/#compatible-release
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.
Right. It will only upgrade to 1.1.X
Signed-off-by: David Caro david@dcaro.es