dccex 0.1.1__tar.gz

dccex-0.1.1/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.3
+Name: dccex
+Version: 0.1.1
+Summary: Locate and run DCC applications
+Author: Henrik Wilhelmsen
+Author-email: Henrik Wilhelmsen <henrik@hwanimation.tech>
+Requires-Dist: dccpath>=0.2.1
+Requires-Python: >=3.14
+Project-URL: Repository, https://git.hwanimation.tech/hwanimationtech/dccex
+Description-Content-Type: text/markdown
+
+# dccex
+
+`dccex` locates installed Digital Content Creation (DCC) applications and runs
+them with the arguments you provide.
+
+Version-specific companion packages expose
+commands such as `blender5` and `maya2026`, making it practical to select a DCC
+version in shell scripts, CI, and project tooling.
+
+See [the packages directory](./packages) for which versioned packages are available.
+
+## Command-line usage
+
+### uv tool
+
+Install a version-specific package once to add its command to the `uv` tools
+bin directory (make sure it is on your `PATH` with `uv tool update-shell`):
+
+```sh
+uv tool install blenderex-5
+blender5
+```
+
+For example, install Maya 2026 and invoke its bundled Python interpreter:
+
+```sh
+uv tool install mayaex-2026
+mayapy2026 --version
+```
+
+### uvx
+
+Use `uvx` when you do not want to keep the command installed. `--from` selects
+the package while the final command is the generated DCC command:
+
+```sh
+uvx --from blenderex-5 blender5
+uvx --from mayaex-2026 mayapy2026 --version
+```
+
+### pixi
+
+Run a version-specific command without adding it to a `pixi.toml` by supplying
+the package as an execution specification:
+
+```sh
+pixi exec --spec blenderex-5 blender5
+pixi exec --spec mayaex-2026 mayapy2026 --version
+```
+
+## Library usage
+
+Add the core package to a Python project, then call `call_dcc_exe` with the
+executable name and required DCC version. It returns the launched process's
+exit code, or `1` when the executable cannot be located.
+
+```sh
+uv add dccex
+```
+
+```python
+import sys
+
+from dccex import call_dcc_exe
+
+exit_code = call_dcc_exe(dcc_exe="blender", version="5", args=["--version"])
+sys.exit(exit_code)
+```
+
+The supported executable names are `"blender"`, `"maya"`, `"mayapy"`,
+`"mobu"`, and `"mobupy"`.
+
+## Development
+
+The version-specific packages are generated from `scripts/data/pkgs.json`:
+
+```sh
+uv run scripts/gen_pkgs.py
+```
+
+Do not edit files under `packages/` directly; update the templates or package
+data and regenerate them instead.
+
+## License
+
+`dccex` is licensed under the [Mozilla Public License 2.0](LICENSE).

dccex-0.1.1/README.md

@@ -0,0 +1,86 @@
+# dccex
+
+`dccex` locates installed Digital Content Creation (DCC) applications and runs
+them with the arguments you provide.
+
+Version-specific companion packages expose
+commands such as `blender5` and `maya2026`, making it practical to select a DCC
+version in shell scripts, CI, and project tooling.
+
+See [the packages directory](./packages) for which versioned packages are available.
+
+## Command-line usage
+
+### uv tool
+
+Install a version-specific package once to add its command to the `uv` tools
+bin directory (make sure it is on your `PATH` with `uv tool update-shell`):
+
+```sh
+uv tool install blenderex-5
+blender5
+```
+
+For example, install Maya 2026 and invoke its bundled Python interpreter:
+
+```sh
+uv tool install mayaex-2026
+mayapy2026 --version
+```
+
+### uvx
+
+Use `uvx` when you do not want to keep the command installed. `--from` selects
+the package while the final command is the generated DCC command:
+
+```sh
+uvx --from blenderex-5 blender5
+uvx --from mayaex-2026 mayapy2026 --version
+```
+
+### pixi
+
+Run a version-specific command without adding it to a `pixi.toml` by supplying
+the package as an execution specification:
+
+```sh
+pixi exec --spec blenderex-5 blender5
+pixi exec --spec mayaex-2026 mayapy2026 --version
+```
+
+## Library usage
+
+Add the core package to a Python project, then call `call_dcc_exe` with the
+executable name and required DCC version. It returns the launched process's
+exit code, or `1` when the executable cannot be located.
+
+```sh
+uv add dccex
+```
+
+```python
+import sys
+
+from dccex import call_dcc_exe
+
+exit_code = call_dcc_exe(dcc_exe="blender", version="5", args=["--version"])
+sys.exit(exit_code)
+```
+
+The supported executable names are `"blender"`, `"maya"`, `"mayapy"`,
+`"mobu"`, and `"mobupy"`.
+
+## Development
+
+The version-specific packages are generated from `scripts/data/pkgs.json`:
+
+```sh
+uv run scripts/gen_pkgs.py
+```
+
+Do not edit files under `packages/` directly; update the templates or package
+data and regenerate them instead.
+
+## License
+
+`dccex` is licensed under the [Mozilla Public License 2.0](LICENSE).

dccex-0.1.1/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "dccex"
+version = "0.1.1"
+description = "Locate and run DCC applications"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = ["dccpath>=0.2.1"]
+
+[[project.authors]]
+name = "Henrik Wilhelmsen"
+email = "henrik@hwanimation.tech"
+
+[project.urls]
+Repository = "https://git.hwanimation.tech/hwanimationtech/dccex"
+
+[dependency-groups]
+dev = [
+    "ruff>=0.16.1",
+    "ty>=0.0.65",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.2,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.workspace]
+members = ["packages/*"]

dccex-0.1.1/pyproject.toml.orig

@@ -0,0 +1,28 @@
+[project]
+name = "dccex"
+version = "0.1.1"
+description = "Locate and run DCC applications"
+readme = "README.md"
+authors = [
+    { name = "Henrik Wilhelmsen", email = "henrik@hwanimation.tech" }
+]
+requires-python = ">=3.14"
+dependencies = [
+    "dccpath>=0.2.1",
+]
+
+[project.urls]
+Repository = "https://git.hwanimation.tech/hwanimationtech/dccex"
+
+[dependency-groups]
+dev = [
+    "ruff>=0.16.1",
+    "ty>=0.0.65",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.2,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.workspace]
+members = ["packages/*"]

dccex-0.1.1/src/dccex/__init__.py

@@ -0,0 +1,78 @@
+# Copyright (C) 2026 Henrik Wilhelmsen.
+#
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at <https://mozilla.org/MPL/2.0/>.
+
+"""DCCEX - A package for finding and running DCC executables."""
+
+import logging
+import os
+import subprocess
+from typing import Literal
+
+from dccpath import (
+    DCCPathError,
+    get_blender,
+    get_maya,
+    get_mayapy,
+    get_mobu,
+    get_mobupy,
+)
+
+logger = logging.getLogger(__name__)
+
+
+SupportedDCCs = Literal["maya", "mayapy", "mobu", "mobupy", "blender"]
+
+
+def call_dcc_exe(
+    dcc_exe: SupportedDCCs,
+    version: str,
+    args: list[str] | None = None,
+) -> int:
+    """Locate and call the given DCC executable for the given version.
+
+    Args:
+        dcc_exe: The DCC to call
+        version: The DCC version
+        args: Optional extra arguments to pass to the DCC
+
+    Returns:
+        The return code of the subprocess call to the executable, or 1 if an error
+        occurred during setup.
+    """
+    if args is None:
+        args = []
+
+    match dcc_exe:
+        case "maya":
+            search_fn = get_maya
+        case "mayapy":
+            search_fn = get_mayapy
+        case "mobu":
+            search_fn = get_mobu
+        case "mobupy":
+            search_fn = get_mobupy
+        case "blender":
+            search_fn = get_blender
+        case _:
+            logger.error("invalid DCC argument: %s", dcc_exe)
+            return 1
+
+    try:
+        executable = search_fn(version=version).resolve().as_posix()
+    except DCCPathError:
+        logger.exception(
+            "an error occurred when trying to get the %s executable",
+            dcc_exe,
+        )
+        return 1
+
+    logger.debug("running dcc executable: %s", executable)
+    return subprocess.call(  # noqa: S603
+        [executable, *args],
+        env=os.environ,
+        encoding="utf-8",
+        text=True,
+    )