René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Implement Extended Version Comparisons (Ranges, Hyphens, Tilde...)","articleBody":"# Situation\r\n\r\nCurrently, ~`semver.VersionInfo`~ `semver.Version` contains a `match` method. However, it does support only a limited number of comparisons. For example, `~` or `^` as known in NPM is unknown.\r\n\r\n# Proposal\r\n\r\nAdd an additional class which provides all the necessary functionality. How this is implemented is a matter of design. :wink: \r\n\r\nI'd suggest to add this after major 3 is released.\r\n\r\nThis could be the use cases (I use a class `Spec` here, but the naming is subject to change):\r\n\r\n```python\r\n\u003e\u003e\u003e import semver\r\n\u003e\u003e\u003e spec = semver.Spec(\"\u003e=1.0 \u003c= 1.7\")\r\n\u003e\u003e\u003e ver = semver.Version.parse(\"1.2.0\")\r\n\r\n\u003e\u003e\u003e spec in ver\r\nTrue\r\n\u003e\u003e\u003e spec.match(ver)\r\nTrue\r\n```\r\n\r\nDepending on how we want to design it, it could also influence, for example, `semver.Version.match`. Maybe we should (re)move that and move this functionality into a future `Spec` class? Wouldn't it a bit more appropriate there?\r\n\r\n@python-semver/reviewers What do you think about this idea? Any preferences?\r\n\r\n# Grammar\r\n\r\n\r\n```\r\nrange-set  ::= range ( logical-or range ) *\r\nlogical-or ::= ( ' ' ) * '||' ( ' ' ) *\r\nrange      ::= hyphen | simple ( ' ' simple ) * | ''\r\nhyphen     ::= partial ' - ' partial\r\nsimple     ::= primitive | partial | tilde | caret\r\nprimitive  ::= ( '\u003c' | '\u003e' | '\u003e=' | '\u003c=' | '=' ) partial\r\npartial    ::= xr ( '.' xr ( '.' xr qualifier ? )? )?\r\nxr         ::= 'x' | 'X' | '*' | nr\r\nnr         ::= '0' | ['1'-'9'] ( ['0'-'9'] ) *\r\ntilde      ::= '~' partial\r\ncaret      ::= '^' partial\r\nqualifier  ::= ( '-' pre )? ( '+' build )?\r\npre        ::= parts\r\nbuild      ::= parts\r\nparts      ::= part ( '.' part ) *\r\npart       ::= nr | [-0-9A-Za-z]+\r\n```\r\n\r\n# See Also\r\n\r\n* https://docs.npmjs.com/cli/v6/using-npm/semver\r\n* https://github.com/rbarrois/python-semanticversion/blob/master/semantic_version/base.py#L586\r\n* http://instaparse.mojombo.com/\r\n* [Parsing a \"simple\" grammar](https://stackoverflow.com/a/43364275)\r\n* [Building Recursive Descent Parsers: The Definitive Guide](https://www.booleanworld.com/building-recursive-descent-parsers-definitive-guide/)\r\n* [Parsing Expressions](https://craftinginterpreters.com/parsing-expressions.html)","author":{"url":"https://github.com/tomschr","@type":"Person","name":"tomschr"},"datePublished":"2020-04-22T11:20:09.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/241/python-semver/issues/241"}