Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
P
python-poetry
Overview
Overview
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
open
python-poetry
Commits
28f708fb
Commit
28f708fb
authored
Mar 31, 2023
by
Randy Döring
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
docs: document Poetry's own versioning scheme
parent
852000f8
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
22 additions
and
0 deletions
+22
-0
docs/faq.md
+22
-0
No files found.
docs/faq.md
View file @
28f708fb
...
...
@@ -33,6 +33,28 @@ Once Poetry has cached the releases' information on your machine, the dependency
will be much faster.
{{% /note %}}
### What kind of versioning scheme does Poetry use for itself?
Poetry uses "major.minor.micro" version identifiers as mentioned in
[
PEP 440
](
https://peps.python.org/pep-0440/#final-releases
)
.
Version bumps are done similar to Python's versioning:
*
A major version bump (incrementing the first number) is only done for breaking changes
if a deprecation cycle is not possible and many users have to perform some manual steps
to migrate from one version to the next one.
*
A minor version bump (incrementing the second number) may include new features as well
as new deprecations and drop features deprecated in an earlier minor release.
*
A micro version bump (incrementing the third number) usually only includes bug fixes.
Deprecated features will not be dropped in a micro release.
### Why does Poetry not adhere to semantic versioning?
Because of its large user base, even small changes not considered relevant by most users
can turn out to be a breaking change for some users in hindsight.
Sticking to strict
[
semantic versioning
](
https://semver.org
)
and (almost) always bumping
the major version instead of the minor version does not seem desirable
since the minor version will not carry any meaning anymore.
### Are unbound version constraints a bad idea?
A version constraint without an upper bound such as
`*`
or
`>=3.4`
will allow updates to any future version of the dependency.
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment