Metadata-Version: 2.4
Name: hypertube-python-sdk
Version: 3.2.1
Summary: Hypertube SDK for Python
Author-email: "Graftcode S.A." <support@graftcode.com>
License: MIT
Project-URL: Homepage, https://www.hypertube.dev/
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: websockets
Requires-Dist: h2
Requires-Dist: pyyaml
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: toml-cli; extra == "dev"
Requires-Dist: ruff; python_version >= "3.7" and extra == "dev"

Hypertube allows you to reference and use modules or packages written in (Java/Kotlin/Groovy/Clojure, C#/VB.NET, Ruby, Perl, Python, JavaScript/TypeScript) like they were created in your technology. It works on Linux/Windows and MacOS for applications created in JVM, CLR/Netcore, Perl, Python, Ruby, NodeJS, C++ or GoLang and gives you unparalleled freedom and flexibility with native performance in building your mixed-technologies products. Let it be accessing best AI or cryptography libraries, devices SDKs, legacy client modules, internal custom packages or anything from public repositories available on NPM, Nuget, PyPI, Maven/Gradle, RubyGems or GitHub. Get free from programming languages barriers today! For more information check out our guides at https://www.hypertube.dev/guides/v2/

## Loading another runtime in the in-memory channel

These settings apply only when this SDK loads a different technology in-process through the in-memory channel. The runtime that hosts the SDK itself is never configured this way. For example, a PHP application does not set `HYPERTUBE_PHP_RUNTIME_PATH`; it sets `HYPERTUBE_PYTHON_RUNTIME_PATH` or `HYPERTUBE_RUBY_RUNTIME_PATH` only when it loads Python or Ruby modules in memory.

- **.NET Framework (CLR)**, Windows only: the latest .NET Framework 4.x installed on the system (4.8 or newer).
- **.NET (netcore)**: the latest .NET runtime installed on the system. Set `runtimePath` for the channel to `net8.0`, `net9.0` or `net10.0` to stay on one major version.
- **Java (JVM)**: the JDK or JRE that `JAVA_HOME` points to. `runtimePath` for the channel or `HYPERTUBE_JVM_RUNTIME_PATH` take precedence.
- **Node.js**: built in. Hypertube ships its own Node.js library, nothing to install.
- **Python, Ruby and PHP**: Hypertube loads the runtime's shared library, not the interpreter executable, in this order:
  1. `runtimePath` set for the channel in the Hypertube configuration.
  2. An environment variable with the full path to the library:
     - `HYPERTUBE_PYTHON_RUNTIME_PATH`, for example `C:\Python313\python313.dll` or `/usr/lib/x86_64-linux-gnu/libpython3.13.so`
     - `HYPERTUBE_RUBY_RUNTIME_PATH`, for example `C:\Ruby34-x64\bin\x64-ucrt-ruby340.dll` or `/usr/local/lib/libruby.so.3.4`
     - `HYPERTUBE_PHP_RUNTIME_PATH`, for example `C:\php85\php8ts.dll` or `/opt/php/8.5/lib/libphp.so`
  3. The library file name in the system library search path: `PATH` on Windows, `LD_LIBRARY_PATH`, the ldconfig cache and default directories on Linux, dyld search paths on macOS.
     - Python 3.14 down to 3.6: `python3XX.dll`, `libpython3.XX.so`, `libpython3.XX.dylib`. Set `HYPERTUBE_PYTHON_VERSION` to load one version: `3.13` on Linux and macOS, `313` on Windows.
     - Ruby 4.0 down to 3.0: `x64-ucrt-ruby340.dll` style names (`x64-msvcrt-` too, `aarch64-ucrt-` on Windows ARM64), `libruby.so` or `libruby.dylib` and their versioned names. With RubyInstaller keep `bin\ruby_builtin_dlls` next to the Ruby DLL.
     - PHP: Thread Safe PHP 8.5 built with the embed SAPI (PHP 8.4 on Windows ARM64): `php8ts.dll`, `libphp.so` or `libphp.dylib`. The NTS `php8.dll` is rejected.
