Add version module with "version" string and parsed "version_info"

Replicates graphql/graphql-js@e2fe67e

Author: Cito

.bumpversion.cfg

@@ -3,7 +3,7 @@ current_version = 1.0.5
 commit = False
 tag = False
 
-[bumpversion:file:graphql/__init__.py]
+[bumpversion:file:graphql/version.py]
 search = __version__ = "{current_version}"
 replace = __version__ = "{new_version}"
 

README.md

@@ -13,7 +13,7 @@ a query language for APIs created by Facebook.
 [![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
 
 The current version 1.0.5 of GraphQL-core-next is up-to-date with GraphQL.js version
-14.3.1. All parts of the API are covered by an extensive test suite of currently 1779
+14.3.1. All parts of the API are covered by an extensive test suite of currently 1787
 unit tests.
 
 

graphql/__init__.py

@@ -37,8 +37,9 @@
   - :mod:`graphql.subscription`: Subscribe to data updates.
 """
 
-__version__ = "1.0.5"
-__version_js__ = "14.3.1"
+# The GraphQL-core-next and GraphQL.js version info.
+
+from .version import version, version_info, version_js, version_info_js
 
 # The primary entry point into fulfilling a GraphQL request.
 
@@ -384,7 +385,20 @@
     find_dangerous_changes,
 )
 
+# The GraphQL-core-next version info.
+__version__ = version
+__version_info__ = version_info
+
+# The GraphQL.js version info.
+__version_js__ = version_js
+__version_info_js__ = version_info_js
+
+
 __all__ = [
+    "version",
+    "version_info",
+    "version_js",
+    "version_info_js",
     "graphql",
     "graphql_sync",
     "GraphQLSchema",

graphql/version.py

@@ -0,0 +1,31 @@
+from typing import NamedTuple
+
+__all__ = ["version", "version_info", "version_js", "version_info_js"]
+
+
+class VersionInfo(NamedTuple):
+    major: int
+    minor: int
+    micro: int
+    releaselevel: str
+    serial: int
+
+    def __str__(self):
+        v = f"{self.major}.{self.minor}.{self.micro}"
+        level = self.releaselevel
+        if level and level != "final":
+            {"alpha": "a", "beta": "b", "candidate": "c"}.get(level, level)
+            v += level
+            serial = self.serial
+            if serial:
+                v = f"{v}{serial}"
+        return v
+
+
+version = "1.0.5"
+
+version_info = VersionInfo(1, 0, 5, "final", 0)
+
+version_js = "14.3.1"
+
+version_info_js = VersionInfo(14, 3, 1, "final", 0)

setup.py

@@ -1,8 +1,8 @@
 from re import search
 from setuptools import setup, find_packages
 
-with open("graphql/__init__.py") as init_file:
-    version = search('__version__ = "(.*)"', init_file.read()).group(1)
+with open("graphql/version.py") as version_file:
+    version = search('version = "(.*)"', version_file.read()).group(1)
 
 with open("README.md") as readme_file:
     readme = readme_file.read()

tests/test_version.py

@@ -0,0 +1,58 @@
+import re
+
+import graphql
+from graphql import version, version_info, version_js, version_info_js
+
+_re_version = re.compile(r"(\d+)\.(\d+)\.(\d+)(?:(a|b|c)(\d+))?$")
+
+
+def describe_version():
+    def test_module_version():
+        assert graphql.__version__ == version
+        assert graphql.version == version
+
+    def test_module_version_info():
+        assert graphql.__version_info__ == version_info
+        assert graphql.version_info == version
+
+    def test_module_version_js():
+        assert graphql.__version_js__ == version_js
+        assert graphql.version_js == version_js
+
+    def test_module_version_info_js():
+        assert graphql.__version_info_js__ == version_info_js
+        assert graphql.version_info_js == version_info_js
+
+    def test_version():
+        assert isinstance(version, str)
+        assert _re_version.match(version)
+
+    def test_version_info():
+        assert isinstance(version_info, tuple)
+        assert str(version_info) == version
+        groups = _re_version.match(version).groups()
+        assert version_info.major == int(groups[0])
+        assert version_info.minor == int(groups[1])
+        assert version_info.micro == int(groups[2])
+        if groups[3] is None:
+            assert groups[4] is None
+        else:
+            assert version_info.releaselevel == groups[3]
+            assert version_info.serial == int(groups[4])
+
+    def test_version_js():
+        assert isinstance(version_js, str)
+        assert _re_version.match(version_js)
+
+    def test_version_info_js():
+        assert isinstance(version_info_js, tuple)
+        assert str(version_info_js) == version_js
+        groups = _re_version.match(version_js).groups()
+        assert version_info_js.major == int(groups[0])
+        assert version_info_js.minor == int(groups[1])
+        assert version_info_js.micro == int(groups[2])
+        if groups[3] is None:
+            assert groups[4] is None
+        else:
+            assert version_info_js.releaselevel == groups[3]
+            assert version_info_js.serial == int(groups[4])