Add support for NPM-style version ranges.

The code follows closely the specification available at
https://docs.npmjs.com/misc/semver.html.

Despite similarities, the matching logic is fully separate from the
`native` code, since both might evolve at their own scales.

1 files changed, 16 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index 0d0d421..257b2a4 100644
--- a/README.rst
+++ b/README.rst
@@ -280,6 +280,22 @@ build metadata is equality.
     False
 
 
+NPM-based ranges
+----------------
+
+The :class:`NpmSpec` class handles NPM-style ranges:
+
+.. code-block:: pycon
+
+    >>> Version('1.2.3') in NpmSpec('1.2.2 - 1.4')
+    True
+    >>> Version('1.2.3') in NpmSpec('<1.x || >=1.2.3')
+    True
+
+Refer to https://docs.npmjs.com/misc/semver.html for a detailed description of NPM
+range syntax.
+
+
 Using with Django
 =================