Make it possible for a package to require a compatible version of Par…

…tCAD (#1)

requirements.txt

@@ -9,4 +9,5 @@ cairosvg==2.7.0
 ocp_vscode==2.0.13
 GitPython==3.1.40
 progress==1.6
-ruamel.yaml==0.18.5
+ruamel.yaml==0.18.5
+packaging==23.1

src/partcad/project_config.py

@@ -9,6 +9,8 @@
 import os
 import json
 import yaml
+from importlib.metadata import version
+from packaging.specifiers import SpecifierSet
 
 DEFAULT_CONFIG_FILENAME = "partcad.yaml"
 
@@ -22,7 +24,7 @@ def __init__(self, config_path=DEFAULT_CONFIG_FILENAME):
         if os.path.isdir(config_path):
             config_path += "/" + DEFAULT_CONFIG_FILENAME
         if not os.path.isfile(config_path):
-            print("PartCad configuration file is not found: %s" % config_path)
+            print("PartCAD configuration file is not found: %s" % config_path)
             return
         self.config_path = config_path
 
@@ -32,3 +34,14 @@ def __init__(self, config_path=DEFAULT_CONFIG_FILENAME):
             self.config_obj = yaml.safe_load(open(config_path, "r"))
         if config_path.endswith(".json"):
             self.config_obj = json.load(open(config_path, "r"))
+
+        if "partcad" in self.config_obj:
+            # See what version of PartCAD is required for this package
+            partcad_requirements = SpecifierSet(self.config_obj["partcad"])
+            partcad_version = version("partcad")
+            if partcad_version not in partcad_requirements:
+                # TODO(clairbee): add better error and exception handling
+                raise Exception(
+                    "ERROR: Incompatible PartCAD version! %s does not satisfy %s"
+                    % (partcad_version, partcad_requirements)
+                )

tests/unit/data/project_config_invalid_1.yaml

@@ -0,0 +1,2 @@
+# This configuration file has the version requirements that always fail
+partcad: "<0.1.0"

tests/unit/data/project_config_valid_1.yaml

@@ -0,0 +1,2 @@
+# This configuration file has the version requirements that always pass
+partcad: ">=0.1.0"

tests/unit/test_project_config.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python3
+#
+# OpenVMP, 2023
+#
+# Author: Roman Kuzmenko
+# Created: 2023-12-27
+#
+# Licensed under Apache License, Version 2.0.
+#
+
+import partcad as pc
+
+
+def test_project_config_version_1():
+    """Positive test case for PartCAD version requirement in the package config file"""
+    try:
+        ctx = pc.Context("tests/unit/data/project_config_valid_1.yaml")
+        assert ctx.config_obj["partcad"] == ">=0.1.0"
+    except Exception as e:
+        assert False, "Valid configuration file caused an exception: %s" % e
+
+
+def test_project_config_version_2():
+    """Negative test case for PartCAD version requirement in the package config file"""
+    try:
+        ctx = pc.Context("tests/unit/data/project_config_invalid_1.yaml")
+        assert False, "Invalid configuration file did not cause an exception"
+    except:
+        _ignore = True