<feed xmlns='http://www.w3.org/2005/Atom'>
<title>delta/python-packages/semantic-version.git/docs, branch master</title>
<subtitle>github.com: rbarrois/python-semanticversion.git
</subtitle>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/'/>
<entry>
<title>Guarantee a stable ordering with build metadata</title>
<updated>2022-05-26T13:34:45+00:00</updated>
<author>
<name>Raphaël Barrois</name>
<email>raphael.barrois@polytechnique.org</email>
</author>
<published>2022-05-26T13:28:23+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/commit/?id=57c78e7307792879dce33734c11e7774383b9d36'/>
<id>57c78e7307792879dce33734c11e7774383b9d36</id>
<content type='text'>
Sorting any permutation of Version objects should always yield the same
result, even if those hold some build metadata.

To that end, the "precedence_key" is now used exclusively for sorting;
direct comparisons between Version objects still ignores the "build"
metadata, using a different precedence key.

For performance improvements, both precedence keys are cached.

Closes: #132
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Sorting any permutation of Version objects should always yield the same
result, even if those hold some build metadata.

To that end, the "precedence_key" is now used exclusively for sorting;
direct comparisons between Version objects still ignores the "build"
metadata, using a different precedence key.

For performance improvements, both precedence keys are cached.

Closes: #132
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: Update reference to NPM range specification</title>
<updated>2022-02-06T18:52:05+00:00</updated>
<author>
<name>Raphaël Barrois</name>
<email>raphael.barrois@paylead.fr</email>
</author>
<published>2022-02-06T18:52:05+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/commit/?id=8a7162fc01b33964688a5be41df3865bceb875c3'/>
<id>8a7162fc01b33964688a5be41df3865bceb875c3</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Improve documentation</title>
<updated>2022-02-06T18:40:53+00:00</updated>
<author>
<name>Raphaël Barrois</name>
<email>raphael.barrois@paylead.fr</email>
</author>
<published>2022-02-06T18:40:53+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/commit/?id=7e59a4b2e82abe4338e307b9fe49b072c9537a15'/>
<id>7e59a4b2e82abe4338e307b9fe49b072c9537a15</id>
<content type='text'>
- The README is now a standalone document, also included as an
  "introduction" page;
- A new "guide" section provides more details on most features;
- A couple of typos were fixed.

The main goal was to make the README file perfectly suitable for
rendering on PyPI, while keeping its content available on the standard
documentation on ReadTheDocs.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
- The README is now a standalone document, also included as an
  "introduction" page;
- A new "guide" section provides more details on most features;
- A couple of typos were fixed.

The main goal was to make the README file perfectly suitable for
rendering on PyPI, while keeping its content available on the standard
documentation on ReadTheDocs.
</pre>
</div>
</content>
</entry>
<entry>
<title>Fix wildcard matching for SimpleSpec.</title>
<updated>2020-04-29T09:46:24+00:00</updated>
<author>
<name>Raphaël Barrois</name>
<email>raphael.barrois@polytechnique.org</email>
</author>
<published>2020-04-29T09:46:24+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/commit/?id=0811fca1c435c1477ee1465578580b491cba6c73'/>
<id>0811fca1c435c1477ee1465578580b491cba6c73</id>
<content type='text'>
Including docs and tests.

Closes #98.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Including docs and tests.

Closes #98.
</pre>
</div>
</content>
</entry>
<entry>
<title>Correct typo in SimpleSpec description</title>
<updated>2019-09-13T12:53:21+00:00</updated>
<author>
<name>Jason</name>
<email>j.and.w.graham@gmail.com</email>
</author>
<published>2019-09-12T23:51:49+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/commit/?id=cfb86ab34051d2cf935b112d4b7a5e7800e703b3'/>
<id>cfb86ab34051d2cf935b112d4b7a5e7800e703b3</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Rewrite `Spec` documentation.</title>
<updated>2019-08-27T21:11:21+00:00</updated>
<author>
<name>Raphaël Barrois</name>
<email>raphael.barrois@polytechnique.org</email>
</author>
<published>2019-08-27T21:11:21+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/commit/?id=a210106cf2493ec284b10c41ff8fb58a4701dbb2'/>
<id>a210106cf2493ec284b10c41ff8fb58a4701dbb2</id>
<content type='text'>
Write clear, explicit rules for the `SimpleSpec` syntax.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Write clear, explicit rules for the `SimpleSpec` syntax.
</pre>
</div>
</content>
</entry>
<entry>
<title>Deprecate support for 'partial' versions.</title>
<updated>2019-08-26T19:37:10+00:00</updated>
<author>
<name>Raphaël Barrois</name>
<email>raphael.barrois@polytechnique.org</email>
</author>
<published>2019-08-24T12:57:46+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/commit/?id=870060605e3955114766a979de1afadbea4dc603'/>
<id>870060605e3955114766a979de1afadbea4dc603</id>
<content type='text'>
Their comparison semantics were ill-defined, and mostly an
implementation detail for the old, 'native' specs.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Their comparison semantics were ill-defined, and mostly an
implementation detail for the old, 'native' specs.
</pre>
</div>
</content>
</entry>
<entry>
<title>Adjust docs for readthedocs.</title>
<updated>2019-08-26T19:34:44+00:00</updated>
<author>
<name>Raphaël Barrois</name>
<email>raphael.barrois@polytechnique.org</email>
</author>
<published>2019-08-24T12:13:30+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/commit/?id=5c1abbef4d86bcd1ec68cf5deb90b559faf25502'/>
<id>5c1abbef4d86bcd1ec68cf5deb90b559faf25502</id>
<content type='text'>
- Use proper theme in development
- Use ReadTheDocs version numbers in titles
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
- Use proper theme in development
- Use ReadTheDocs version numbers in titles
</pre>
</div>
</content>
</entry>
<entry>
<title>Add `Version.precedence_key`.</title>
<updated>2019-08-26T19:34:44+00:00</updated>
<author>
<name>Raphaël Barrois</name>
<email>raphael.barrois@polytechnique.org</email>
</author>
<published>2019-08-24T12:04:55+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/commit/?id=c415ee4cd87915191b1ca8df2d3fbf7e49d4bbbf'/>
<id>c415ee4cd87915191b1ca8df2d3fbf7e49d4bbbf</id>
<content type='text'>
This will be used in `sort(..., key=lambda v: v.precedence_key)`.
Remove previous comparison/ordering implementation.

The current implementation relies on a 4-tuple:
- major, minor, patch (as integers) - natural order matches precedence
  rules
- a tuple of identifiers for the prerelease component.

The identifiers for the prerelease components are based on:
- A `NumericIdentifier` class, that compares number using their natural
  order, and always compares lower than non-numeric identifiers
- A `AlphaIdentifier` class for non-numeric identifiers; it compares
  versions using ASCII ordering.
- A `MaxIdentifier` class, that compares higher to any other identifier;
  used to ensure that a non-prerelease version is greater than any of
  its prereleases.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
This will be used in `sort(..., key=lambda v: v.precedence_key)`.
Remove previous comparison/ordering implementation.

The current implementation relies on a 4-tuple:
- major, minor, patch (as integers) - natural order matches precedence
  rules
- a tuple of identifiers for the prerelease component.

The identifiers for the prerelease components are based on:
- A `NumericIdentifier` class, that compares number using their natural
  order, and always compares lower than non-numeric identifiers
- A `AlphaIdentifier` class for non-numeric identifiers; it compares
  versions using ASCII ordering.
- A `MaxIdentifier` class, that compares higher to any other identifier;
  used to ensure that a non-prerelease version is greater than any of
  its prereleases.
</pre>
</div>
</content>
</entry>
<entry>
<title>Add deprecations for Spec/SpecItem.</title>
<updated>2019-08-26T19:34:44+00:00</updated>
<author>
<name>Raphaël Barrois</name>
<email>raphael.barrois@polytechnique.org</email>
</author>
<published>2019-08-23T22:08:16+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/semantic-version.git/commit/?id=7688b54c4a6005a75301a2e6a477f402311a6a2d'/>
<id>7688b54c4a6005a75301a2e6a477f402311a6a2d</id>
<content type='text'>
The internal features from those classes will be removed in future
versions:

- The `Spec` class is incompatible with the support of multiple syntaxes
- The `SpecItem` class was an implementation detail, but doesn't support
  complex `Range` combinations.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
The internal features from those classes will be removed in future
versions:

- The `Spec` class is incompatible with the support of multiple syntaxes
- The `SpecItem` class was an implementation detail, but doesn't support
  complex `Range` combinations.
</pre>
</div>
</content>
</entry>
</feed>
