add circuitpython code

1 files changed, 354 insertions, 0 deletions

diff --git a/circuitpython/tools/python-semver/tests.py b/circuitpython/tools/python-semver/tests.py
new file mode 100644
index 0000000..a3e2ab7
--- /dev/null
+++ b/circuitpython/tools/python-semver/tests.py
@@ -0,0 +1,354 @@
+import pytest  # noqa
+
+from semver import compare
+from semver import match
+from semver import parse
+from semver import format_version
+from semver import bump_major
+from semver import bump_minor
+from semver import bump_patch
+from semver import bump_prerelease
+from semver import bump_build
+from semver import finalize_version
+from semver import min_ver
+from semver import max_ver
+from semver import VersionInfo
+
+
+SEMVERFUNCS = [
+    compare, match, parse, format_version,
+    bump_major, bump_minor, bump_patch, bump_prerelease, bump_build,
+    max_ver, min_ver, finalize_version
+]
+
+
+@pytest.mark.parametrize("func", SEMVERFUNCS,
+                         ids=[func.__name__ for func in SEMVERFUNCS])
+def test_fordocstrings(func):
+    assert func.__doc__, "Need a docstring for function %r" % func.__name
+
+
+def test_should_parse_version():
+    result = parse("1.2.3-alpha.1.2+build.11.e0f985a")
+    assert result == {
+        'major': 1,
+        'minor': 2,
+        'patch': 3,
+        'prerelease': 'alpha.1.2',
+        'build': 'build.11.e0f985a',
+    }
+
+    result = parse("1.2.3-alpha-1+build.11.e0f985a")
+    assert result == {
+        'major': 1,
+        'minor': 2,
+        'patch': 3,
+        'prerelease': 'alpha-1',
+        'build': 'build.11.e0f985a',
+    }
+
+
+def test_should_parse_zero_prerelease():
+    result = parse("1.2.3-rc.0+build.0")
+
+    assert result == {
+        'major': 1,
+        'minor': 2,
+        'patch': 3,
+        'prerelease': 'rc.0',
+        'build': 'build.0',
+    }
+
+    result = parse("1.2.3-rc.0.0+build.0")
+
+    assert result == {
+        'major': 1,
+        'minor': 2,
+        'patch': 3,
+        'prerelease': 'rc.0.0',
+        'build': 'build.0',
+    }
+
+
+def test_should_get_less():
+    assert compare("1.0.0", "2.0.0") == -1
+    assert compare('1.0.0-alpha', '1.0.0-alpha.1') == -1
+    assert compare('1.0.0-alpha.1', '1.0.0-alpha.beta') == -1
+    assert compare('1.0.0-alpha.beta', '1.0.0-beta') == -1
+    assert compare('1.0.0-beta', '1.0.0-beta.2') == -1
+    assert compare('1.0.0-beta.2', '1.0.0-beta.11') == -1
+    assert compare('1.0.0-beta.11', '1.0.0-rc.1') == -1
+    assert compare('1.0.0-rc.1', '1.0.0') == -1
+
+
+def test_should_get_greater():
+    assert compare("2.0.0", "1.0.0") == 1
+    assert compare('1.0.0-alpha.1', '1.0.0-alpha') == 1
+    assert compare('1.0.0-alpha.beta', '1.0.0-alpha.1') == 1
+    assert compare('1.0.0-beta', '1.0.0-alpha.beta') == 1
+    assert compare('1.0.0-beta.2', '1.0.0-beta') == 1
+    assert compare('1.0.0-beta.11', '1.0.0-beta.2') == 1
+    assert compare('1.0.0-rc.1', '1.0.0-beta.11') == 1
+    assert compare('1.0.0', '1.0.0-rc.1') == 1
+
+
+def test_should_match_simple():
+    assert match("2.3.7", ">=2.3.6") is True
+
+
+def test_should_no_match_simple():
+    assert match("2.3.7", ">=2.3.8") is False
+
+
+def test_should_match_not_equal():
+    assert match("2.3.7", "!=2.3.8") is True
+    assert match("2.3.7", "!=2.3.6") is True
+    assert match("2.3.7", "!=2.3.7") is False
+
+
+def test_should_not_raise_value_error_for_expected_match_expression():
+    assert match("2.3.7", "<2.4.0") is True
+    assert match("2.3.7", ">2.3.5") is True
+
+    assert match("2.3.7", "<=2.3.9") is True
+    assert match("2.3.7", ">=2.3.5") is True
+    assert match("2.3.7", "==2.3.7") is True
+    assert match("2.3.7", "!=2.3.7") is False
+
+
+def test_should_raise_value_error_for_unexpected_match_expression():
+    with pytest.raises(ValueError):
+        match("2.3.7", "=2.3.7")
+    with pytest.raises(ValueError):
+        match("2.3.7", "~2.3.7")
+    with pytest.raises(ValueError):
+        match("2.3.7", "^2.3.7")
+
+
+def test_should_raise_value_error_for_zero_prefixed_versions():
+    with pytest.raises(ValueError):
+        parse("01.2.3")
+    with pytest.raises(ValueError):
+        parse("1.02.3")
+    with pytest.raises(ValueError):
+        parse("1.2.03")
+
+
+def test_should_raise_value_error_for_invalid_value():
+    with pytest.raises(ValueError):
+        compare('foo', 'bar')
+    with pytest.raises(ValueError):
+        compare('1.0', '1.0.0')
+    with pytest.raises(ValueError):
+        compare('1.x', '1.0.0')
+
+
+def test_should_raise_value_error_for_invalid_match_expression():
+    with pytest.raises(ValueError):
+        match('1.0.0', '')
+    with pytest.raises(ValueError):
+        match('1.0.0', '!')
+    with pytest.raises(ValueError):
+        match('1.0.0', '1.0.0')
+
+
+def test_should_follow_specification_comparison():
+    """
+    produce comparison chain:
+    1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta.2 < 1.0.0-beta.11
+    < 1.0.0-rc.1 < 1.0.0-rc.1+build.1 < 1.0.0 < 1.0.0+0.3.7 < 1.3.7+build
+    < 1.3.7+build.2.b8f12d7 < 1.3.7+build.11.e0f985a
+    and in backward too.
+    """
+    chain = [
+        '1.0.0-alpha', '1.0.0-alpha.1', '1.0.0-beta.2', '1.0.0-beta.11',
+        '1.0.0-rc.1', '1.0.0', '1.3.7+build',
+    ]
+    versions = zip(chain[:-1], chain[1:])
+    for low_version, high_version in versions:
+        assert compare(low_version, high_version) == -1, \
+            '%s should be lesser than %s' % (low_version, high_version)
+        assert compare(high_version, low_version) == 1,  \
+            '%s should be higher than %s' % (high_version, low_version)
+
+
+def test_should_compare_rc_builds():
+    assert compare('1.0.0-beta.2', '1.0.0-beta.11') == -1
+
+
+def test_should_compare_release_candidate_with_release():
+    assert compare('1.0.0-rc.1', '1.0.0') == -1
+    assert compare('1.0.0-rc.1+build.1', '1.0.0') == -1
+
+
+def test_should_say_equal_versions_are_equal():
+    assert compare('2.0.0', '2.0.0') == 0
+    assert compare('1.1.9-rc.1', '1.1.9-rc.1') == 0
+    assert compare('1.1.9+build.1', '1.1.9+build.1') == 0
+    assert compare('1.1.9-rc.1+build.1', '1.1.9-rc.1+build.1') == 0
+
+
+def test_should_compare_versions_with_build_and_release():
+    assert compare('1.1.9-rc.1', '1.1.9-rc.1+build.1') == 0
+    assert compare('1.1.9-rc.1', '1.1.9+build.1') == -1
+
+
+def test_should_ignore_builds_on_compare():
+    assert compare('1.0.0+build.1', '1.0.0') == 0
+    assert compare('1.0.0-alpha.1+build.1', '1.0.0-alpha.1') == 0
+    assert compare('1.0.0+build.1', '1.0.0-alpha.1') == 1
+    assert compare('1.0.0+build.1', '1.0.0-alpha.1+build.1') == 1
+
+
+def test_should_correctly_format_version():
+    assert format_version(3, 4, 5) == '3.4.5'
+    assert format_version(3, 4, 5, 'rc.1') == '3.4.5-rc.1'
+    assert format_version(3, 4, 5, prerelease='rc.1') == '3.4.5-rc.1'
+    assert format_version(3, 4, 5, build='build.4') == '3.4.5+build.4'
+    assert format_version(3, 4, 5, 'rc.1', 'build.4') == '3.4.5-rc.1+build.4'
+
+
+def test_should_bump_major():
+    assert bump_major('3.4.5') == '4.0.0'
+
+
+def test_should_bump_minor():
+    assert bump_minor('3.4.5') == '3.5.0'
+
+
+def test_should_bump_patch():
+    assert bump_patch('3.4.5') == '3.4.6'
+
+
+def test_should_ignore_extensions_for_bump():
+    assert bump_patch('3.4.5-rc1+build4') == '3.4.6'
+
+
+def test_should_get_max():
+    assert max_ver('3.4.5', '4.0.2') == '4.0.2'
+
+
+def test_should_get_min():
+    assert min_ver('3.4.5', '4.0.2') == '3.4.5'
+
+
+def test_should_get_min_same():
+    assert min_ver('3.4.5', '3.4.5') == '3.4.5'
+
+
+def test_should_get_more_rc1():
+    assert compare("1.0.0-rc1", "1.0.0-rc0") == 1
+
+
+def test_prerelease_order():
+    assert min_ver('1.2.3-rc.2', '1.2.3-rc.10') == '1.2.3-rc.2'
+    assert min_ver('1.2.3-rc2', '1.2.3-rc10') == '1.2.3-rc10'
+    # identifiers with letters or hyphens are compared lexically in ASCII sort
+    # order.
+    assert min_ver('1.2.3-Rc10', '1.2.3-rc10') == '1.2.3-Rc10'
+    # Numeric identifiers always have lower precedence than non-numeric
+    # identifiers.
+    assert min_ver('1.2.3-2', '1.2.3-rc') == '1.2.3-2'
+    # A larger set of pre-release fields has a higher precedence than a
+    # smaller set, if all of the preceding identifiers are equal.
+    assert min_ver('1.2.3-rc.2.1', '1.2.3-rc.2') == '1.2.3-rc.2'
+    # When major, minor, and patch are equal, a pre-release version has lower
+    # precedence than a normal version.
+    assert min_ver('1.2.3', '1.2.3-1') == '1.2.3-1'
+    assert min_ver('1.0.0-alpha', '1.0.0-alpha.1') == '1.0.0-alpha'
+
+
+def test_should_bump_prerelease():
+    assert bump_prerelease('3.4.5-rc.9') == '3.4.5-rc.10'
+    assert bump_prerelease('3.4.5') == '3.4.5-rc.1'
+    assert bump_prerelease('3.4.5', 'dev') == '3.4.5-dev.1'
+    assert bump_prerelease('3.4.5', '') == '3.4.5-rc.1'
+
+
+def test_should_ignore_build_on_prerelease_bump():
+    assert bump_prerelease('3.4.5-rc.1+build.4') == '3.4.5-rc.2'
+
+
+def test_should_bump_build():
+    assert bump_build('3.4.5-rc.1+build.9') == '3.4.5-rc.1+build.10'
+    assert bump_build('3.4.5-rc.1+0009.dev') == '3.4.5-rc.1+0010.dev'
+    assert bump_build('3.4.5-rc.1') == '3.4.5-rc.1+build.1'
+    assert bump_build('3.4.5') == '3.4.5+build.1'
+    assert bump_build('3.4.5', 'nightly') == '3.4.5+nightly.1'
+    assert bump_build('3.4.5', '') == '3.4.5+build.1'
+
+
+def test_should_finalize_version():
+    assert finalize_version('1.2.3') == '1.2.3'
+    assert finalize_version('1.2.3-rc.5') == '1.2.3'
+    assert finalize_version('1.2.3+build.2') == '1.2.3'
+    assert finalize_version('1.2.3-rc.1+build.5') == '1.2.3'
+    assert finalize_version('1.2.3-alpha') == '1.2.3'
+    assert finalize_version('1.2.0') == '1.2.0'
+
+
+def test_should_compare_version_info_objects():
+    v1 = VersionInfo(major=0, minor=10, patch=4, prerelease=None, build=None)
+    v2 = VersionInfo(
+        major=0, minor=10, patch=4, prerelease='beta.1', build=None)
+
+    # use `not` to enforce using comparision operators
+    assert v1 != v2
+    assert v1 > v2
+    assert v1 >= v2
+    assert not(v1 < v2)
+    assert not(v1 <= v2)
+    assert not(v1 == v2)
+
+    v3 = VersionInfo(major=0, minor=10, patch=4, prerelease=None, build=None)
+
+    assert not(v1 != v3)
+    assert not(v1 > v3)
+    assert v1 >= v3
+    assert not(v1 < v3)
+    assert v1 <= v3
+    assert v1 == v3
+
+    v4 = VersionInfo(major=0, minor=10, patch=5, prerelease=None, build=None)
+    assert v1 != v4
+    assert not(v1 > v4)
+    assert not(v1 >= v4)
+    assert v1 < v4
+    assert v1 <= v4
+    assert not(v1 == v4)
+
+
+def test_should_compare_version_dictionaries():
+    v1 = VersionInfo(major=0, minor=10, patch=4, prerelease=None, build=None)
+    v2 = dict(major=0, minor=10, patch=4, prerelease='beta.1', build=None)
+
+    assert v1 != v2
+    assert v1 > v2
+    assert v1 >= v2
+    assert not(v1 < v2)
+    assert not(v1 <= v2)
+    assert not(v1 == v2)
+
+    v3 = dict(major=0, minor=10, patch=4, prerelease=None, build=None)
+
+    assert not(v1 != v3)
+    assert not(v1 > v3)
+    assert v1 >= v3
+    assert not(v1 < v3)
+    assert v1 <= v3
+    assert v1 == v3
+
+    v4 = dict(major=0, minor=10, patch=5, prerelease=None, build=None)
+    assert v1 != v4
+    assert not(v1 > v4)
+    assert not(v1 >= v4)
+    assert v1 < v4
+    assert v1 <= v4
+    assert not(v1 == v4)
+
+
+def test_should_compare_prerelease_with_numbers_and_letters():
+    v1 = VersionInfo(major=1, minor=9, patch=1, prerelease='1unms', build=None)
+    v2 = VersionInfo(major=1, minor=9, patch=1, prerelease=None, build='1asd')
+    assert v1 < v2
+    assert compare("1.9.1-1unms", "1.9.1+1") == -1