feat: define VRS schema version in package (#543)

supercedes #467. In that PR, I defined a hook for setuptools that would
use the tag info in a submodule and auto-update a variable with the
latest VRS schema tag, so that wheels built by our release workflow
would contain the right value. There were probably going to be some
hiccups that way, though, and I also couldn't get it to be testable in
github actions on account of how actions/checkout seemed to be pulling
the git repos.

Here, we just define a little old constant with the schema version. This
is a fully manual process, but theoretically we won't need to update it
that often, so it should be fine.

Author: jsstevenson

src/ga4gh/vrs/__init__.py

@@ -1,6 +1,4 @@
-"""Public interface to the GA4GH Variation Representation reference
-implementation
-"""
+"""Public interface to the GA4GH Variation Representation reference implementation"""
 
 from importlib.metadata import PackageNotFoundError, version
 
@@ -9,11 +7,21 @@
 from ga4gh.vrs.models import VrsType
 from ga4gh.vrs.normalize import normalize
 
-__all__ = ["VrsType", "models", "normalize", "vrs_deref", "vrs_enref"]
-
 try:
     __version__ = version(__name__)
 except PackageNotFoundError:  # pragma: nocover
     __version__ = "unknown"
 finally:
     del version, PackageNotFoundError
+
+
+VRS_VERSION = "2.0.1"
+
+__all__ = [
+    "VRS_VERSION",
+    "VrsType",
+    "models",
+    "normalize",
+    "vrs_deref",
+    "vrs_enref",
+]

src/ga4gh/vrs/extras/annotator/vcf.py

@@ -13,7 +13,7 @@
     VrsObjectIdentifierIs,
     use_ga4gh_compute_identifier_when,
 )
-from ga4gh.vrs import __version__
+from ga4gh.vrs import VRS_VERSION, __version__
 from ga4gh.vrs.dataproxy import _DataProxy
 from ga4gh.vrs.extras.translator import AlleleTranslator
 from ga4gh.vrs.models import Allele
@@ -137,8 +137,7 @@ def _update_vcf_header(
             info_field_num,
             "String",
             (
-                "The computed identifiers for the GA4GH VRS Alleles corresponding to the "
-                f"GT indexes of the {info_field_desc} alleles [VRS-Python version {__version__}]"
+                f"The computed identifiers for the GA4GH VRS Alleles corresponding to the GT indexes of the {info_field_desc} alleles [VRS version={VRS_VERSION};VRS-Python version={__version__}]"
             ),
         )
         vcf.header.info.add(

tests/extras/data/test_vcf_expected_altsonly_output.vcf.gz

@@ -8,7 +8,7 @@
 
 import pytest
 
-from ga4gh.vrs import __version__
+from ga4gh.vrs import VRS_VERSION, __version__
 from ga4gh.vrs.dataproxy import DataProxyValidationError, SeqRepoRESTDataProxy
 from ga4gh.vrs.extras.annotator.vcf import VcfAnnotator, VcfAnnotatorError
 
@@ -47,6 +47,7 @@ def compare_vcfs(actual_vcf_path: Path, expected_vcf_path: Path):
         out_vcf_lines, expected_output_lines, strict=False
     ):
         if actual_line.startswith("##INFO=<ID=VRS_Allele_IDs"):
+            expected_line = expected_line.replace("1111", VRS_VERSION)
             expected_line = expected_line.replace("9999", __version__)
         assert actual_line == expected_line