pythonnet 3.2.0rc1__cp311.cp312.cp313.cp314.cp315-none-any.whl

clr.py

@@ -0,0 +1,6 @@
+"""
+Legacy Python.NET loader for backwards compatibility
+"""
+
+from pythonnet import load
+load()

pythonnet/__init__.py

@@ -0,0 +1,168 @@
+"""Python.NET runtime loading and configuration"""
+
+import sys
+from pathlib import Path
+from typing import Dict, Optional, Union, Any
+import clr_loader
+
+__all__ = ["set_runtime", "set_runtime_from_env", "load", "unload", "get_runtime_info"]
+
+_RUNTIME: Optional[clr_loader.Runtime] = None
+_LOADER_ASSEMBLY: Optional[clr_loader.Assembly] = None
+_LOADED: bool = False
+
+
+def set_runtime(runtime: Union[clr_loader.Runtime, str], **params: str) -> None:
+    """Set up a clr_loader runtime without loading it
+
+    :param runtime:
+        Either an already initialised `clr_loader` runtime, or one of netfx,
+        coreclr, mono, or default. If a string parameter is given, the runtime
+        will be created.
+    """
+
+    global _RUNTIME
+    if _LOADED:
+        raise RuntimeError(f"The runtime {_RUNTIME} has already been loaded")
+
+    if isinstance(runtime, str):
+        runtime = _create_runtime_from_spec(runtime, params)
+
+    _RUNTIME = runtime
+
+
+def get_runtime_info() -> Optional[clr_loader.RuntimeInfo]:
+    """Retrieve information on the configured runtime"""
+
+    if _RUNTIME is None:
+        return None
+    else:
+        return _RUNTIME.info()
+
+
+def _get_params_from_env(prefix: str) -> Dict[str, str]:
+    from os import environ
+
+    full_prefix = f"PYTHONNET_{prefix.upper()}_"
+    len_ = len(full_prefix)
+
+    env_vars = {
+        (k[len_:].lower()): v
+        for k, v in environ.items()
+        if k.upper().startswith(full_prefix)
+    }
+
+    return env_vars
+
+
+def _create_runtime_from_spec(
+    spec: str, params: Optional[Dict[str, Any]] = None
+) -> clr_loader.Runtime:
+    was_default = False
+    if spec == "default":
+        was_default = True
+        if sys.platform == "win32":
+            spec = "netfx"
+        else:
+            spec = "mono"
+
+    params = params or _get_params_from_env(spec)
+
+    try:
+        if spec == "netfx":
+            return clr_loader.get_netfx(**params)
+        elif spec == "mono":
+            return clr_loader.get_mono(**params)
+        elif spec == "coreclr":
+            return clr_loader.get_coreclr(**params)
+        else:
+            raise RuntimeError(f"Invalid runtime name: '{spec}'")
+    except Exception as exc:
+        if was_default:
+            raise RuntimeError(
+                f"""Failed to create a default .NET runtime, which would
+                    have been "{spec}" on this system. Either install a
+                    compatible runtime or configure it explicitly via
+                    `set_runtime` or the `PYTHONNET_*` environment variables
+                    (see set_runtime_from_env)."""
+            ) from exc
+        else:
+            raise RuntimeError(
+                f"""Failed to create a .NET runtime ({spec}) using the
+                parameters {params}."""
+            ) from exc
+
+
+def set_runtime_from_env() -> None:
+    """Set up the runtime using the environment
+
+    This will use the environment variable PYTHONNET_RUNTIME to decide the
+    runtime to use, which may be one of netfx, coreclr or mono. The parameters
+    of the respective clr_loader.get_<runtime> functions can also be given as
+    environment variables, named `PYTHONNET_<RUNTIME>_<PARAM_NAME>`. In
+    particular, to use `PYTHONNET_RUNTIME=coreclr`, the variable
+    `PYTHONNET_CORECLR_RUNTIME_CONFIG` has to be set to a valid
+    `.runtimeconfig.json`.
+
+    If no environment variable is specified, a globally installed Mono is used
+    for all environments but Windows, on Windows the legacy .NET Framework is
+    used.
+    """
+    from os import environ
+
+    spec = environ.get("PYTHONNET_RUNTIME", "default")
+    runtime = _create_runtime_from_spec(spec)
+    set_runtime(runtime)
+
+
+def load(runtime: Union[clr_loader.Runtime, str, None] = None, **params: str) -> None:
+    """Load Python.NET in the specified runtime
+
+    The same parameters as for `set_runtime` can be used. By default,
+    `set_default_runtime` is called if no environment has been set yet and no
+    parameters are passed.
+
+    After a successful call, further invocations will return immediately."""
+    global _LOADED, _LOADER_ASSEMBLY
+
+    if _LOADED:
+        return
+
+    if _RUNTIME is None:
+        if runtime is None:
+            set_runtime_from_env()
+        else:
+            set_runtime(runtime, **params)
+
+    if _RUNTIME is None:
+        raise RuntimeError("No valid runtime selected")
+
+    dll_path = Path(__file__).parent / "runtime" / "Python.Runtime.dll"
+
+    _LOADER_ASSEMBLY = assembly = _RUNTIME.get_assembly(str(dll_path))
+    func = assembly.get_function("Python.Runtime.Loader.Initialize")
+
+    if func(b"") != 0:
+        raise RuntimeError("Failed to initialize Python.Runtime.dll")
+    
+    _LOADED = True
+
+    import atexit
+
+    atexit.register(unload)
+
+
+def unload() -> None:
+    """Explicitly unload a loaded runtime and shut down Python.NET"""
+
+    global _RUNTIME, _LOADER_ASSEMBLY
+    if _LOADER_ASSEMBLY is not None:
+        func = _LOADER_ASSEMBLY.get_function("Python.Runtime.Loader.Shutdown")
+        if func(b"full_shutdown") != 0:
+            raise RuntimeError("Failed to call Python.NET shutdown")
+
+        _LOADER_ASSEMBLY = None
+
+    if _RUNTIME is not None:
+        _RUNTIME.shutdown()
+        _RUNTIME = None

pythonnet/_pyinstaller/__init__.py

@@ -0,0 +1,4 @@
+import os
+
+def get_hook_dirs():
+    return [os.path.dirname(__file__)]

pythonnet/_pyinstaller/hook-clr.py

@@ -0,0 +1,9 @@
+from PyInstaller.utils.hooks import collect_data_files, collect_dynamic_libs
+
+try:
+    binaries = collect_dynamic_libs("pythonnet")
+    datas = collect_data_files("pythonnet")
+except Exception:
+    # name conflict with https://pypi.org/project/clr/, do not crash if just clr is present
+    binaries = []
+    datas = []

pythonnet/runtime/Python.Runtime.deps.json

@@ -0,0 +1,173 @@
+{
+  "runtimeTarget": {
+    "name": ".NETStandard,Version=v2.0/",
+    "signature": ""
+  },
+  "compilationOptions": {},
+  "targets": {
+    ".NETStandard,Version=v2.0": {},
+    ".NETStandard,Version=v2.0/": {
+      "Python.Runtime/3.2.0-rc1": {
+        "dependencies": {
+          "Microsoft.CSharp": "4.7.0",
+          "Microsoft.SourceLink.GitHub": "10.0.401",
+          "System.Reflection.Emit": "4.7.0"
+        },
+        "runtime": {
+          "Python.Runtime.dll": {}
+        }
+      },
+      "Microsoft.CSharp/4.7.0": {
+        "runtime": {
+          "lib/netstandard2.0/Microsoft.CSharp.dll": {
+            "assemblyVersion": "4.0.5.0",
+            "fileVersion": "4.700.19.56404"
+          }
+        }
+      },
+      "Microsoft.SourceLink.GitHub/10.0.401": {
+        "dependencies": {
+          "System.IO.Hashing": "10.0.12"
+        }
+      },
+      "System.Buffers/4.6.1": {
+        "runtime": {
+          "lib/netstandard2.0/System.Buffers.dll": {
+            "assemblyVersion": "4.0.2.0",
+            "fileVersion": "4.600.125.16908"
+          }
+        }
+      },
+      "System.IO.Hashing/10.0.12": {
+        "dependencies": {
+          "System.Buffers": "4.6.1",
+          "System.Memory": "4.6.3"
+        },
+        "runtime": {
+          "lib/netstandard2.0/System.IO.Hashing.dll": {
+            "assemblyVersion": "10.0.0.12",
+            "fileVersion": "10.0.1226.42308"
+          }
+        }
+      },
+      "System.Memory/4.6.3": {
+        "dependencies": {
+          "System.Buffers": "4.6.1",
+          "System.Numerics.Vectors": "4.6.1",
+          "System.Runtime.CompilerServices.Unsafe": "6.1.2"
+        },
+        "runtime": {
+          "lib/netstandard2.0/System.Memory.dll": {
+            "assemblyVersion": "4.0.2.0",
+            "fileVersion": "4.600.325.20307"
+          }
+        }
+      },
+      "System.Numerics.Vectors/4.6.1": {
+        "runtime": {
+          "lib/netstandard2.0/System.Numerics.Vectors.dll": {
+            "assemblyVersion": "4.1.3.0",
+            "fileVersion": "4.600.125.16908"
+          }
+        }
+      },
+      "System.Reflection.Emit/4.7.0": {
+        "dependencies": {
+          "System.Reflection.Emit.ILGeneration": "4.7.0"
+        },
+        "runtime": {
+          "lib/netstandard2.0/System.Reflection.Emit.dll": {
+            "assemblyVersion": "4.0.0.0",
+            "fileVersion": "4.700.19.56404"
+          }
+        }
+      },
+      "System.Reflection.Emit.ILGeneration/4.7.0": {
+        "runtime": {
+          "lib/netstandard2.0/System.Reflection.Emit.ILGeneration.dll": {
+            "assemblyVersion": "4.0.0.0",
+            "fileVersion": "4.700.19.56404"
+          }
+        }
+      },
+      "System.Runtime.CompilerServices.Unsafe/6.1.2": {
+        "runtime": {
+          "lib/netstandard2.0/System.Runtime.CompilerServices.Unsafe.dll": {
+            "assemblyVersion": "6.0.0.0",
+            "fileVersion": "6.100.225.20307"
+          }
+        }
+      }
+    }
+  },
+  "libraries": {
+    "Python.Runtime/3.2.0-rc1": {
+      "type": "project",
+      "serviceable": false,
+      "sha512": ""
+    },
+    "Microsoft.CSharp/4.7.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-pTj+D3uJWyN3My70i2Hqo+OXixq3Os2D1nJ2x92FFo6sk8fYS1m1WLNTs0Dc1uPaViH0YvEEwvzddQ7y4rhXmA==",
+      "path": "microsoft.csharp/4.7.0",
+      "hashPath": "microsoft.csharp.4.7.0.nupkg.sha512"
+    },
+    "Microsoft.SourceLink.GitHub/10.0.401": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-LGmlwgP1Cx37JEWzyjS0o1/+xs/s/e3E2TBSuogI5ePA/9L0pfIfeYX0k5in7Bfcw8Nn2y2sG9jXxydTjiR2Fg==",
+      "path": "microsoft.sourcelink.github/10.0.401",
+      "hashPath": "microsoft.sourcelink.github.10.0.401.nupkg.sha512"
+    },
+    "System.Buffers/4.6.1": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-N8GXpmiLMtljq7gwvyS+1QvKT/W2J8sNAvx+HVg4NGmsG/H+2k/y9QI23auLJRterrzCiDH+IWAw4V/GPwsMlw==",
+      "path": "system.buffers/4.6.1",
+      "hashPath": "system.buffers.4.6.1.nupkg.sha512"
+    },
+    "System.IO.Hashing/10.0.12": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-jDix4bBMYnpZdSPcnY+KDV6ik3SRMzpMKby/bZl/XUwIiflwRNAFZ0oOl61R/pSaveIJ8t1gs2BUlrGsPs/bcg==",
+      "path": "system.io.hashing/10.0.12",
+      "hashPath": "system.io.hashing.10.0.12.nupkg.sha512"
+    },
+    "System.Memory/4.6.3": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-qdcDOgnFZY40+Q9876JUHnlHu7bosOHX8XISRoH94fwk6hgaeQGSgfZd8srWRZNt5bV9ZW2TljcegDNxsf+96A==",
+      "path": "system.memory/4.6.3",
+      "hashPath": "system.memory.4.6.3.nupkg.sha512"
+    },
+    "System.Numerics.Vectors/4.6.1": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-sQxefTnhagrhoq2ReR0D/6K0zJcr9Hrd6kikeXsA1I8kOCboTavcUC4r7TSfpKFeE163uMuxZcyfO1mGO3EN8Q==",
+      "path": "system.numerics.vectors/4.6.1",
+      "hashPath": "system.numerics.vectors.4.6.1.nupkg.sha512"
+    },
+    "System.Reflection.Emit/4.7.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-VR4kk8XLKebQ4MZuKuIni/7oh+QGFmZW3qORd1GvBq/8026OpW501SzT/oypwiQl4TvT8ErnReh/NzY9u+C6wQ==",
+      "path": "system.reflection.emit/4.7.0",
+      "hashPath": "system.reflection.emit.4.7.0.nupkg.sha512"
+    },
+    "System.Reflection.Emit.ILGeneration/4.7.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-AucBYo3DSI0IDxdUjKksBcQJXPHyoPyrCXYURW1WDsLI4M65Ar/goSHjdnHOAY9MiYDNKqDlIgaYm+zL2hA1KA==",
+      "path": "system.reflection.emit.ilgeneration/4.7.0",
+      "hashPath": "system.reflection.emit.ilgeneration.4.7.0.nupkg.sha512"
+    },
+    "System.Runtime.CompilerServices.Unsafe/6.1.2": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-2hBr6zdbIBTDE3EhK7NSVNdX58uTK6iHW/P/Axmm9sl1xoGSLqDvMtpecn226TNwHByFokYwJmt/aQQNlO5CRw==",
+      "path": "system.runtime.compilerservices.unsafe/6.1.2",
+      "hashPath": "system.runtime.compilerservices.unsafe.6.1.2.nupkg.sha512"
+    }
+  }
+}