Allow loading of Argon documents from a different directory.

.github/workflows/deploy.yaml

@@ -8,13 +8,13 @@ on:
 jobs:
   build-and-release-package:
     if: github.repository == 'cmlibs-python/cmlibs.argon'
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     name: Release package
     permissions:
       contents: write
       id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
     steps:
       - name: Release Python package
-        uses: hsorby/release-python-package-action@v1
+        uses: hsorby/release-python-package-action@v2
         with:
           pypi-package-name: cmlibs.argon

.gitignore

@@ -132,3 +132,4 @@ dmypy.json
 # Sphinx mock directory
 docs/mock/
 
+.idea/

pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=61.0", "setuptools_scm>=8.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools-git-versioning]
+enabled = true
+
+[project]
+name = "cmlibs.argon"
+dynamic = ["version"]
+keywords = ["Argon", "ArgonDocument", "CMLibs", "Zinc"]
+readme = "README.rst"
+license = "Apache-2.0"
+authors = [
+    { name="Hugh Sorby", email="h.sorby@auckland.ac.nz" },
+]
+dependencies = [
+    "packaging",
+    "cmlibs.zinc >= 4.1.3"
+]
+description = "CMLibs Argon visualisation descriptions."
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Medical Science Apps.",
+]
+
+[project.urls]
+Homepage = "https://cmlibs.org"
+Repository = "https://github.com/CMLibs-Python/cmlibs.argon"
+
+[tool.setuptools_scm]

src/cmlibs/argon/argondocument.py

@@ -119,7 +119,7 @@ def _regionChange(self, changedRegion, treeChange):
             zincRootRegion = changedRegion.getZincRegion()
             self._zincContext.setDefaultRegion(zincRootRegion)
 
-    def deserialize(self, state):
+    def deserialize(self, state, base_path=None):
         """
         Read the JSON description to the argon document object. This will change the settings of ArgonDocument Object.
 
@@ -145,7 +145,7 @@ def deserialize(self, state):
             self._materials.deserialize(d["Materials"])
         if "Views" in d:
             self._view_manager.deserialize(d["Views"])
-        self._rootRegion.deserialize(d["RootRegion"])
+        self._rootRegion.deserialize(d["RootRegion"], base_path)
 
     def serialize(self, base_path=None):
         """