Release version 0.0.0.dev432

Author: AAriam

pkg/pyproject.toml

@@ -17,7 +17,7 @@ namespaces = true
 # ----------------------------------------- Project Metadata -------------------------------------
 #
 [project]
-version = "0.0.0.dev431"
+version = "0.0.0.dev432"
 name = "ControlMan"
 dependencies = [
     "packaging >= 23.2, < 24",
@@ -27,18 +27,18 @@ dependencies = [
     "jsonpath-ng == 1.6.1",
     "ruamel.yaml == 0.18.6",
     "Jinja2 >= 3, < 4",
-    "PyLinks == 0.0.0.dev71",
-    "LoggerMan == 0.0.0.dev88",
-    "PySerials == 0.0.0.dev61",
-    "GitTidy == 0.0.0.dev86",
+    "PyLinks == 0.0.0.dev72",
+    "LoggerMan == 0.0.0.dev89",
+    "PySerials == 0.0.0.dev62",
+    "GitTidy == 0.0.0.dev87",
     "PkgData == 0.0.0.dev5",
-    "PyShellMan == 0.0.0.dev48",
+    "PyShellMan == 0.0.0.dev49",
     "PySyntax == 0.0.0.dev6",
-    "ExceptionMan == 0.0.0.dev58",
-    "MDit == 0.0.0.dev58",
-    "JSONSchemata == 0.0.0.dev57",
+    "ExceptionMan == 0.0.0.dev59",
+    "MDit == 0.0.0.dev59",
+    "JSONSchemata == 0.0.0.dev58",
     "VersionMan == 0.0.0.dev250",
     "HTMP == 0.0.0.dev5",
-    "LicenseMan == 0.0.0.dev45",
+    "LicenseMan == 0.0.0.dev46",
 ]
 requires-python = ">=3.10"

pkg/requirements.txt

@@ -5,16 +5,16 @@ referencing == 0.35.1
 jsonpath-ng == 1.6.1
 ruamel.yaml == 0.18.6
 Jinja2 >= 3, < 4
-PyLinks == 0.0.0.dev71
-LoggerMan == 0.0.0.dev88
-PySerials == 0.0.0.dev61
-GitTidy == 0.0.0.dev86
+PyLinks == 0.0.0.dev72
+LoggerMan == 0.0.0.dev89
+PySerials == 0.0.0.dev62
+GitTidy == 0.0.0.dev87
 PkgData == 0.0.0.dev5
-PyShellMan == 0.0.0.dev48
+PyShellMan == 0.0.0.dev49
 PySyntax == 0.0.0.dev6
-ExceptionMan == 0.0.0.dev58
-MDit == 0.0.0.dev58
-JSONSchemata == 0.0.0.dev57
+ExceptionMan == 0.0.0.dev59
+MDit == 0.0.0.dev59
+JSONSchemata == 0.0.0.dev58
 VersionMan == 0.0.0.dev250
 HTMP == 0.0.0.dev5
-LicenseMan == 0.0.0.dev45
+LicenseMan == 0.0.0.dev46

pkg/src/controlman/__init__.py

@@ -28,6 +28,7 @@ def manager(
     github_token: str | None = None,
     future_versions: dict[str, str] | None = None,
     control_center_path: str | None = None,
+    validate: bool = True,
 ):
     if isinstance(repo, (str, _Path)):
         repo = _Git(path=repo)
@@ -38,7 +39,7 @@ def manager(
                 raise ValueError(f"Invalid control center path '{cc_path}'")
             data_before = _ps.NestedDict()
         else:
-            data_before = from_json_file(repo_path=repo.repo_path)
+            data_before = from_json_file(repo_path=repo.repo_path, validate=validate)
             cc_path = repo.repo_path / data_before["control.path"]
     else:
         cc_path = repo.repo_path / data_before["control.path"]
@@ -56,6 +57,7 @@ def manager(
 def from_json_file(
     repo_path: str | _Path,
     filepath: str = const.FILEPATH_METADATA,
+    validate: bool = True,
 ) -> _ps.NestedDict:
     """Load control center data from the full JSON file.
 
@@ -65,6 +67,8 @@ def from_json_file(
         Path to the repository root.
     filepath : str, default: controlman.const.FILEPATH_METADATA
         Relative path to the JSON file in the repository.
+    validate
+        Validate the data against the schema.
 
     Raises
     ------
@@ -75,7 +79,8 @@ def from_json_file(
         data = _ps.read.json_from_file(path=_Path(repo_path) / filepath)
     except _ps.exception.read.PySerialsReadException as e:
         raise _exception.load.ControlManInvalidMetadataError(cause=e, filepath=filepath) from None
-    _data_validator.validate(data=data, fill_defaults=False)
+    if validate:
+        _data_validator.validate(data=data, fill_defaults=False)
     return _ps.NestedDict(data)
 
 

pkg/src/controlman/_data/schema/def/cache-retention-hours.yaml

@@ -7,10 +7,12 @@ description: |
   After the specified duration,
   the cached data is considered stale
   and will be automatically synced with the source.
+  Set the retention hours to `.inf` to disable cache expiration.
 type: object
-additionalProperties: false
 default: { }
-required: [ extension, repo, user, orcid, doi, python ]
+required: [ extension, repo, user, orcid, doi, python, license ]
+additionalProperties:
+  $ref: https://jsonschemata.repodynamics.com/number/non-negative
 properties:
   extension:
     description: |

pkg/src/controlman/_data/schema/def/dep_conda_env.yaml

@@ -62,11 +62,11 @@ properties:
         type: string
         default: |-
           #{{
-            spec = [get("..channel")]
+            spec = [get(".channel")]
             for part_name, part_prefix in (
               ("subdir", "/"), ("name", "::"), ("version", " "), ("build", " ")
             ):
-                part = get(f"..{part_name}")
+                part = get(f".{part_name}")
                 if part:
                     spec.append(f"{part_prefix}{part}")
             return "".join(spec)

pkg/src/controlman/_data/schema/def/dep_pip_env.yaml

@@ -63,12 +63,12 @@ properties:
         type: string
         default: |-
           #{{
-            spec = [get("..name")]
-            if extras := get("..extras"):
+            spec = [get(".name")]
+            if extras := get(".extras"):
                 spec.append(f"[{','.join(extras)}]")
-            if version := get("..version"):
+            if version := get(".version"):
                 spec.append(version)
-            if marker := get("..marker"):
+            if marker := get(".marker"):
                 spec.append(f"; {marker}")
             return " ".join(spec)
           }}#

pkg/src/controlman/_data/schema/def/dependency.yaml

@@ -7,7 +7,7 @@ description: |
   to run, build, test, or develop the project. 
   Dependencies can be installed using package managers or custom scripts.
 type: object
-required: [ name, import_name, install ]
+required: [ name, install ]
 properties:
   import_name:
     description: |
@@ -17,6 +17,7 @@ properties:
   name:
     description: Name of the module.
     $ref: https://jsonschemata.repodynamics.com/string/oneline
+    default: ${{ .__key__ }}$
   description:
     description: A description for the module.
     type: string
@@ -48,11 +49,6 @@ properties:
       source:
         description: URL of the source code.
         $ref: https://jsonschemata.repodynamics.com/url/http-ftp-sftp
-  file:
-    summary: Dynamic files related to the module.
-    type: object
-    additionalProperties:
-      $ref: https://controlman.repodynamics.com/schema/dynamic-file
   intersphinx_mapping:
     description: Intersphinx mapping definition of the module.
     type: object
@@ -99,7 +95,7 @@ properties:
             default: |
               #{{
                 import re
-                dep_name = get("..name")
+                dep_name = get("...name")
                 name_normalized = re.sub(r"[^a-zA-Z0-9._-]", "-", dep_name).lower()
                 return re.sub(r"^[^a-zA-Z0-9]+|[^a-zA-Z0-9]+$", "", name_normalized)
               }}#
@@ -133,22 +129,18 @@ properties:
           spec:
             summary: Full match specification.
             readOnly: true
-            type: object
-            properties:
-              environment:
-                summary: Specification for an `environment.yml` file.
-                type: string
-                default: |-
-                  #{{
-                    spec = [get("..channel")]
-                    for part_name, part_prefix in (
-                      ("subdir", "/"), ("name", "::"), ("version", " "), ("build", " ")
-                    ):
-                        part = get(f"..{part_name}")
-                        if part:
-                            spec.append(f"{part_prefix}{part}")
-                    return "".join(spec)
-                  }}#
+            type: string
+            default: |-
+              #{{
+                spec = [get(".channel")]
+                for part_name, part_prefix in (
+                  ("subdir", "/"), ("name", "::"), ("version", " "), ("build", " ")
+                ):
+                    part = get(f".{part_name}")
+                    if part:
+                        spec.append(f"{part_prefix}{part}")
+                return "".join(spec)
+              }}#
       pip:
         title: pip
         summary: Specifications for the `pip` package manager.
@@ -169,7 +161,7 @@ properties:
             default: |
               #{{
                 import re
-                dep_name = get("..name")
+                dep_name = get("...name")
                 name_normalized = re.sub(r"[^a-zA-Z0-9._-]", "-", dep_name).lower()
                 return re.sub(r"^[^a-zA-Z0-9]+|[^a-zA-Z0-9]+$", "", name_normalized)
               }}#
@@ -183,8 +175,6 @@ properties:
               [version Specifiers](https://packaging.python.org/en/latest/specifications/version-specifiers/#id5).
             examples:
               - ">=1.21.2"
-            default: >-
-              #{{ return get("..conda.version", "") }}#
           extras:
             summary: >-
               List of 
@@ -205,21 +195,18 @@ properties:
           spec:
             summary: Full dependency specifier.
             readOnly: true
-            type: object
-            properties:
-              pep508:
-                type: string
-                default: |-
-                  #{{
-                    spec = [get("..name")]
-                    if extras := get("..extras"):
-                        spec.append(f"[{','.join(extras)}]")
-                    if version := get("..version"):
-                        spec.append(version)
-                    if marker := get("..marker"):
-                        spec.append(f"; {marker}")
-                    return " ".join(spec)
-                  }}#
+            type: string
+            default: |-
+              #{{
+                spec = [get(".name")]
+                if extras := get(".extras"):
+                    spec.append(f"[{','.join(extras)}]")
+                if version := get(".version"):
+                    spec.append(version)
+                if marker := get(".marker"):
+                    spec.append(f"; {marker}")
+                return " ".join(spec)
+              }}#
       apt:
         summary: Specifications for the `apt-get` package manager.
         type: object
@@ -232,7 +219,7 @@ properties:
             default: |
               #{{
                 import re
-                dep_name = get("..name")
+                dep_name = get("...name")
                 name_normalized = re.sub(r"[^a-zA-Z0-9._-]", "-", dep_name).lower()
                 return re.sub(r"^[^a-zA-Z0-9]+|[^a-zA-Z0-9]+$", "", name_normalized)
               }}#
@@ -431,7 +418,7 @@ properties:
         summary: Custom PowerShell script to install the package.
         type: string
   selector:
-    summary: Dependency selector.
+    summary: Selector to apply to the dependency.
     $ref: https://jsonschemata.repodynamics.com/string/oneline
   validator:
     summary: Dependency installation validator.

pkg/src/controlman/_data/schema/def/devcontainer.yaml

@@ -323,17 +323,19 @@ properties:
       items:
         type: string
   postCreateCommand:
-    type:
-      - string
-      - array
-      - object
+    type: object
     description: A command to run after creating the container. This command is
       run after "updateContentCommand" and before "postStartCommand". If this
       is a single string, it will be run in a shell. If this is an array of strings,
       it will be run as a single command without shell. If this is an object,
       each provided command will be run in parallel.
-    items:
-      type: string
+    default: { }
+    properties:
+      source_tasks:
+        summary: Source the tasks file in the user's bashrc.
+        type: string
+        default: >-
+          echo 'source ${{ ..workspaceFolder }}$/${{ ...path }}$/${{ devcontainer.containers.rel_path.tasks }}$' >> ~/.bashrc
     additionalProperties:
       type:
         - string

pkg/src/controlman/_data/schema/def/dynamic-data.yaml

@@ -15,4 +15,4 @@ properties:
     description: |
       This is used to validate the configuration content.
       If the content does not match the schema, an error will be raised.
-    type: object
+    $ref: https://controlman.repodynamics.com/schema/jsonschema