cgcpp 1.8.2__py3-none-win_amd64.whl

cgcpp/__init__.py

@@ -0,0 +1,113 @@
+"""
+(c) Andriy Babak 2021-2025
+
+date: 31/05/2021
+modified: 03/04/2025 12:10:58
+
+Author: Andriy Babak
+e-mail: ababak@gmail.com
+------------------------------
+description: CG C++ Support module
+Containerized builds and runtime loading
+------------------------------
+"""
+
+import importlib.metadata
+import importlib.util
+import inspect
+import os
+import platform
+import sys
+from pathlib import Path
+
+__version__ = importlib.metadata.version("cgcpp")
+__copyright__ = "(c) Andriy Babak 2021-2025"
+
+from . import build
+
+lib_loader_name = "lib_loader"
+lib_suffix = f"_python{sys.version_info.major}{sys.version_info.minor}"
+lib_loader_path = Path(__file__).with_name(f"{lib_loader_name}{lib_suffix}.pyd")
+
+spec = importlib.util.spec_from_file_location(lib_loader_name, lib_loader_path)
+lib_loader = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(lib_loader)
+
+
+def get_library_path(lib_path, extra_frames=0):
+    """
+    Try to guess a full library path
+    """
+    lib_path = Path(lib_path)
+    lib_dir = lib_path.parent
+    lib_name = os.path.basename(lib_path)
+    lib_name, lib_ext = os.path.splitext(lib_path.name)
+    local_platform = platform.system().lower()
+    if local_platform == "windows":
+        lib_ext = ".dll"
+    elif local_platform == "linux":
+        lib_ext = ".so"
+    else:
+        raise EnvironmentError(f"Unsupported platform: {local_platform}")
+    if not os.path.dirname(lib_path):
+        # get call stack frames
+        frames = inspect.stack(0)
+        frame = 1 + extra_frames
+        # should be the third frame
+        # 0: this function
+        # 1: this module"s "call" function
+        # 2: the caller
+        if len(frames) > frame:
+            path = frames[frame][1]
+            if path:
+                lib_dir = Path(path).parent
+    full_lib_path = lib_dir.absolute() / f"{lib_name}{lib_ext}"
+    variants = [f"{lib_name}{lib_ext}", f"{lib_name}{lib_suffix}{lib_ext}"]
+    # Try to guess the host application
+    try:
+        from maya import cmds
+    except ImportError:
+        pass
+    else:
+        # The host application is Maya
+        maya_version = cmds.about(v=True)
+        maya_suffix = f"_maya{maya_version}"
+        variants.append(f"{lib_name}{maya_suffix}{lib_ext}")
+        variants.append(f"{lib_name}{lib_suffix}{maya_suffix}{lib_ext}")
+    try:
+        import hou
+        from hou import nodes
+    except ImportError:
+        pass
+    else:
+        # The host application is Houdini
+        houdini_version = os.path.splitext(hou.applicationVersionString())[0]
+        houdini_suffix = f"_houdini{houdini_version}"
+        variants.append(f"{lib_name}{houdini_suffix}{lib_ext}")
+        variants.append(f"{lib_name}{lib_suffix}{houdini_suffix}{lib_ext}")
+    for name in variants:
+        full_lib_path = lib_dir.absolute() / name
+        if full_lib_path.is_file():
+            return full_lib_path
+    raise AttributeError(
+        f'Library not found: "{lib_dir.absolute().with_name(lib_name + lib_ext)}"'
+    )
+
+
+def call(*args, **kwargs):
+    """
+    Call an external function from dynamically loaded library
+    Arguments:
+        lib (str) - full library path ("/some/lib/lib.so") or library name ("lib")
+        func (str) - function name
+        All the arguments get passed to an exported function from the library
+    Usage:
+        ret = cpp.call("some argument", some_named_argument=42, lib="/lib/path.so", func="custom")
+    """
+    lib_path = kwargs.get("lib")
+    func_name = kwargs.get("func")
+    if not lib_path or not func_name:
+        raise AttributeError('Invalid usage. Expected arguments: "lib", "func"')
+    modified_kwargs = dict(kwargs)
+    modified_kwargs["lib"] = get_library_path(lib_path, extra_frames=1).as_posix()
+    return lib_loader.call(*args, **modified_kwargs)

cgcpp/__main__.py

@@ -0,0 +1,69 @@
+"""
+(c) Andriy Babak 2021-2024
+
+date: 01/06/2021
+modified: 30/01/2025 14:12:22
+
+Author: Andriy Babak
+e-mail: ababak@gmail.com
+------------------------------
+description: CG C++ Support module
+------------------------------
+"""
+
+import argparse
+import os
+import sys
+
+from . import __copyright__, __version__, build
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="C++ module builder v{}".format(__version__),
+        epilog=__copyright__,
+        prog="python -m cgcpp",
+    )
+    parser.add_argument(
+        "source", type=str, help="directory containing CMakeLists.txt to build"
+    )
+    parser.add_argument("--out", help="output directory")
+    parser.add_argument("--build", help="build directory")
+    maya_default_directory = "C:/Program Files/Autodesk"
+    parser.add_argument(
+        "--maya",
+        help='Autodesk directory with Maya installations. Default: "{}".'.format(
+            maya_default_directory
+        ),
+        nargs="?",
+        const=maya_default_directory,
+    )
+    sidefx_default_directory = "C:/Program Files/Side Effects Software"
+    parser.add_argument(
+        "--houdini",
+        help='SideFX directory with Houdini installations. Default: "{}".'.format(
+            sidefx_default_directory
+        ),
+        nargs="?",
+        const=sidefx_default_directory,
+    )
+    args, unknownargs = parser.parse_known_args()
+    source_dir = os.path.abspath(args.source).replace("\\", "/")
+    build_dir = args.build and os.path.abspath(args.build).replace("\\", "/")
+    out_dir = os.path.abspath(args.out or source_dir).replace("\\", "/")
+    if not os.path.isdir(args.source):
+        print('[ERROR] Directory does not exist: "{}"'.format(source_dir))
+        sys.exit(1)
+    result = build.build(
+        source_dir=source_dir,
+        destination_dir=out_dir,
+        build_dir=build_dir,
+        maya_dir=args.maya,
+        houdini_dir=args.houdini,
+    )
+    if not result:
+        sys.exit(result)
+
+
+if __name__ == "__main__":
+    main()

cgcpp/build.py

@@ -0,0 +1,74 @@
+"""
+(c) Andriy Babak 2021-2024
+
+date: 03/06/2021
+modified: 30/05/2024 10:40:26
+
+Author: Andriy Babak
+e-mail: ababak@gmail.com
+------------------------------
+description: CG C++ Support module
+------------------------------
+"""
+
+import os
+import subprocess
+
+from . import __version__
+
+DOCKER_APP = "docker"
+DOCKER_IMAGE = "ababak/cgcpp:" + ".".join(__version__.split(".")[:2])
+
+
+def build(
+    source_dir,
+    destination_dir=None,
+    build_dir=None,
+    maya_dir=None,
+    houdini_dir=None,
+):
+    """Run docker image to build source directory."""
+    source_dir = os.path.abspath(source_dir).replace("\\", "/")
+    destination_dir = os.path.abspath(destination_dir or source_dir).replace("\\", "/")
+    try:
+        out = subprocess.check_output([DOCKER_APP, "images", "-q", DOCKER_IMAGE])
+    except OSError:
+        print("[ERROR] Docker not installed")
+        return 2
+    if not out:
+        print("[ERROR] Docker image is not available: {}".format(DOCKER_IMAGE))
+        print("Please reinstall cgcpp to rebuild it")
+        return 3
+    print('Source: "{}"'.format(source_dir))
+    print('Build: "{}"'.format(build_dir))
+    print('Output: "{}"'.format(destination_dir))
+    docker_args = [
+        DOCKER_APP,
+        "run",
+        "--rm",
+        "-v",
+        "{}:c:/source:ro".format(os.path.abspath(source_dir)),
+        "-v",
+        "{}:c:/out".format(os.path.abspath(destination_dir)),
+    ]
+    if build_dir:
+        docker_args += ["-v", "{}:c:/build".format(os.path.abspath(build_dir))]
+    if maya_dir:
+        maya_dir = os.path.abspath(maya_dir).replace("\\", "/")
+        if not os.path.isdir(maya_dir):
+            print(
+                '[ERROR] Autodesk Maya directory does not exist: "{}"'.format(maya_dir)
+            )
+            return 1
+        docker_args += ["-v", maya_dir + ":c:/autodesk:ro"]
+        print('Autodesk Maya search directory: "{}"'.format(maya_dir))
+    if houdini_dir:
+        houdini_dir = os.path.abspath(houdini_dir).replace("\\", "/")
+        if not os.path.isdir(houdini_dir):
+            print('[ERROR] SideFX directory does not exist: "{}"'.format(houdini_dir))
+            return 1
+        docker_args += ["-v", houdini_dir + ":c:/sidefx:ro"]
+        print('SideFX search directory: "{}"'.format(houdini_dir))
+    docker_args.append(DOCKER_IMAGE)
+    subprocess.check_call(docker_args)
+    return 0

cgcpp-1.8.2.dist-info/METADATA

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: cgcpp
+Version: 1.8.2
+Summary: CG C++ Support module
+Author-email: Andriy Babak <ababak@gmail.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/ababak/cgcpp
+Project-URL: Repository, https://github.com/ababak/cgcpp.git
+Description-Content-Type: text/markdown
+
+[![Docker Image CI](https://github.com/ababak/cgcpp/actions/workflows/docker-image.yml/badge.svg)](https://github.com/ababak/cgcpp/actions/workflows/docker-image.yml)
+
+# Computer Graphics C++ (cgcpp)  
+A universal C++ solution for common needs in computer graphics software.
+
+### Supported Environments  
+- **Python & Boost Versions** (Windows):  
+  - Python 3.9, Boost 1.76.0  
+  - Python 3.10, Boost 1.80.0  
+  - Python 3.11, Boost 1.82.0  
+  - Python 3.12, Boost 1.85.0  
+- **Autodesk Maya** (Windows):  
+  - Maya 2023: Python 3.9, Boost 1.76.0  
+  - Maya 2024: Python 3.10, Boost 1.80.0  
+  - Maya 2025: Python 3.11, Boost 1.82.0  
+  - Maya 2026: Python 3.11, Boost 1.85.0  
+- **SideFX Houdini** (Windows):  
+  - Houdini 19.5: Python 3.9, Boost 1.76.0  
+  - Houdini 20.0: Python 3.10, Boost 1.80.0  
+  - Houdini 20.5: Python 3.11, Boost 1.82.0  
+
+Support for additional platforms and DCC applications may be added in the future.
+
+### Features  
+- **Isolated builds** inside a Docker container for a predictable environment  
+- **Python-C++ integration** to call C++ functions from Python  
+- **Dynamic library reloading** (updates libraries on each new call)  
+- **Python exception handling** from C++  
+
+## Installation  
+Install in your Windows Python virtual environment: 
+
+    python -m pip install git+https://github.com/ababak/cgcpp.git
+
+or
+
+    pip install cgcpp
+
+## Building Examples
+
+    mkdir out
+    python -m cgcpp examples/source_exception --out ./out
+    python -m cgcpp examples/source_maya --out ./out --maya
+    python -m cgcpp examples/source_houdini --out ./out --houdini
+
+Ensure you have Maya and Houdini installed in their default locations as specified in `CMakeLists.txt`
+
+## Testing Built Examples
+Should throw `AttributeError: Some error` exception:
+
+    python -c 'import cgcpp;cgcpp.call(lib="out/lib_exception", func="call")'
+
+Inside Maya:
+
+    import cgcpp
+    print(cgcpp.call(lib="out/maya_module", func="ls"))
+
+Inside Houdini:
+
+    import cgcpp
+    print(cgcpp.call(lib="out/houdini_module", func="ls"))

cgcpp-1.8.2.dist-info/RECORD

@@ -0,0 +1,11 @@
+cgcpp/__init__.py,sha256=qf7rPszcBspZJtA33c7nQwnHju-ec-BzKX1mX-UXiF0,3881
+cgcpp/__main__.py,sha256=SHNrpVIurEUdaCeHcorJn23jiP3O-6u41oY_qrcs6eg,2073
+cgcpp/build.py,sha256=TizhFU3LBGCxUu0RnoTzSOMxAJIZpOzZGW1AButHXZg,2434
+cgcpp/lib_loader_python310.pyd,sha256=RlKLAiIse_PtApdxfWuOPSIhHXF9mR0Om6n7CM8yyzI,134656
+cgcpp/lib_loader_python311.pyd,sha256=hA8T1jXVZVqp85tpKl5-90U6c9a9Xqj61mD-iXJWsWs,134656
+cgcpp/lib_loader_python312.pyd,sha256=LP6b_3yZjgvptXzGhB253kedmMuAySajjYEtgxjCam8,140288
+cgcpp/lib_loader_python39.pyd,sha256=XJNC6gck1bGaD0MCcpMIGO4OCNorg3SnpSTgMnYpdlI,130048
+cgcpp-1.8.2.dist-info/METADATA,sha256=nqgvIlu2tblbM6CL_DIbhVFqmQEH1HKrlLyUNvB1Cpc,2425
+cgcpp-1.8.2.dist-info/WHEEL,sha256=Uot1xtv2NjZkWGfsbtixFxGSupJDmWFZZuntJdtO4yI,98
+cgcpp-1.8.2.dist-info/top_level.txt,sha256=FiFBFxcRpL25SIiVvvzdLJgbYHR17k1haJMNvE2v3oM,6
+cgcpp-1.8.2.dist-info/RECORD,,

cgcpp-1.8.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (78.1.0)
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64
+

cgcpp-1.8.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+cgcpp