lenient_semver 0.4.2

Lenient Semantic Version numbers.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

// To render as railroad, paste the content of this file at
// https://tabatkins.github.io/railroad-diagrams/generator.html
// For documentation on what this means, visit
// http://tabatkins.github.io/railroad-diagrams/
Diagram(
  Stack(
    Sequence(

      // leading whitespace is skipped
      Choice(1, NonTerminal('whitespace'), Skip()),

      // leading v is allowed
      Choice(2,
        Terminal('V'),
        Terminal('v'),
        Skip(),
      ),

      // require at least the major version
      NonTerminal('major'),

      // the following minor and patch versions are optional
      Optional(
        Sequence(
          Terminal('.'),
          NonTerminal('minor'),
          Optional(
            Sequence(
              Terminal('.'),
              NonTerminal('patch')
            )
          )
        )
      ),

    ),

    // regular numbers
    Optional(
      Sequence(
        OneOrMore(
          Terminal('.'),
          NonTerminal('number'),
        ),
        Comment("Parses as build identifier"),
      ),
      'skip'
    ),

    // release and build identifiers
    Choice(0,

      // optional pre-release and build parsing
      Sequence(

        // optional pre-release parsing
        Choice(1,
          // pre-release identifiers are optional
          Skip(),
          // pre-release parsing
          Sequence(
            // pre-release delimter
            Choice(0,
              Terminal('-'),
              Terminal('.'),
            ),
            // followed by a pre-release identifier
            // or many of them delimited with the same delimiters
            OneOrMore(
              NonTerminal('pre-release'),
              Choice(0,
                Terminal('.'),
                Terminal('-'),
              )
            ),
          ),
        ),

        // optional build parsing
        Choice(1,
          // build identifiers are optional
          Skip(),
          // build parsing
          Sequence(
            // build delimter
            Terminal('+'),
            // followed by a build identifier
            // or many of them delimited with the same delimiters as the pre-release identifiers
            OneOrMore(
              NonTerminal('build'),
              Choice(0,
                Terminal('.'),
                Terminal('-'),
              )
            ),
          ),
        )
      ),

      // special branch into `.Final` or `.Release` build identifiers
      Sequence(
        Choice(1,
          Terminal('-'),
          Terminal('.'),
          Terminal('+'),
        ),
        Choice(1,
          Terminal('Final'),
          Terminal('Release'),
          Terminal('r'),
        ),
        Comment("Parses as build identifier"),
      ),
    ),

    // trailing whitespace is skipped
    Choice(1, NonTerminal('whitespace'), Skip()),
  ),
)