rom-runtime 0.0.2__tar.gz

rom_runtime-0.0.2/Cargo.toml

@@ -0,0 +1,47 @@
+[workspace]
+members = [
+    "crates/rom-core",
+    "crates/rom-webapi",
+    "crates/rom-runtime",
+]
+default-members = [
+    "crates/rom-core",
+    "crates/rom-webapi",
+    "crates/rom-runtime",
+]
+resolver = "2"
+
+[workspace.package]
+edition = "2024"
+homepage = "https://github.com/Rxflex/rom"
+license = "MIT"
+repository = "https://github.com/Rxflex/rom"
+version = "0.1.0"
+
+[workspace.dependencies]
+aes = "0.8.4"
+aes-kw = "0.2.1"
+aes-gcm = "0.10.3"
+base64 = "0.22.1"
+boring = "5.0.2"
+cbc = "0.1.2"
+hkdf = "0.12.4"
+hmac = "0.12.1"
+getrandom = "0.3.3"
+httparse = "1.10.1"
+pbkdf2 = "0.12.2"
+rcgen = "0.14.7"
+rom-core = { path = "crates/rom-core" }
+rom-runtime = { path = "crates/rom-runtime" }
+rom-webapi = { path = "crates/rom-webapi" }
+rquickjs = "0.11.0"
+rustls = "0.23.37"
+serde = { version = "1.0.228", features = ["derive"] }
+serde_json = "1.0.145"
+sha1 = "0.10.6"
+sha2 = "0.10.9"
+thiserror = "2.0.17"
+tungstenite = { version = "0.28.0", features = ["rustls-tls-native-roots"] }
+typenum = "1.19.0"
+ureq = "3.2.0"
+url = "2.5.7"

rom_runtime-0.0.2/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: rom-runtime
+Version: 0.0.2
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Summary: Python wrapper for the ROM browser-like runtime
+Keywords: rom,runtime,browser,web-api,fingerprint
+Home-Page: https://github.com/Rxflex/rom
+Author: Rxflex
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/Rxflex/rom
+Project-URL: Issues, https://github.com/Rxflex/rom/issues
+Project-URL: Repository, https://github.com/Rxflex/rom
+
+# `rom-runtime`
+
+Python bindings for the ROM browser-like runtime.
+
+This package exposes a thin Python API on top of ROM:
+
+- `eval()`
+- `eval_async()`
+- `eval_json()`
+- `surface_snapshot()`
+- `fingerprint_probe()`
+- `run_fingerprintjs_harness()`
+- `fingerprintjs_version()`
+
+It prefers a native `PyO3` extension when available and falls back to the ROM CLI bridge otherwise.
+
+## Install
+
+```bash
+pip install rom-runtime
+```
+
+## Usage
+
+```python
+from rom import RomRuntime, has_native_binding
+
+runtime = RomRuntime(
+    {
+        "href": "https://example.test/",
+        "cors_enabled": False,
+        "proxy_url": None,
+    }
+)
+href = runtime.eval_async("(async () => location.href)()")
+snapshot = runtime.surface_snapshot()
+
+print("native:", has_native_binding())
+print(href)
+print(snapshot["fetch"])
+```
+
+Config keys use the Rust runtime field names, so use snake_case such as `cors_enabled` and `proxy_url`.
+`cors_enabled` is `False` by default.
+
+## Optional native build from source
+
+```bash
+python -m pip install maturin
+python -m maturin build --manifest-path bindings/gom-python/Cargo.toml --release
+```
+
+Tagged GitHub releases build and publish wheels for Linux, Windows, and macOS, plus an sdist for source installs.
+
+## Common methods
+
+- `eval()`
+- `eval_async()`
+- `eval_json()`
+- `surface_snapshot()`
+- `fingerprint_probe()`
+- `run_fingerprintjs_harness()`
+- `fingerprintjs_version()`
+
+## Environment
+
+- `ROM_FORCE_CLI_BRIDGE=1`: disable the native path and force CLI fallback
+- `ROM_BRIDGE_BIN`: explicit path to the `rom_bridge` executable
+- `ROM_BRIDGE_CWD`: working directory used by the CLI fallback
+
+## More docs
+
+- Root guide: [../../README.md](../../README.md)
+- LLM guide: [../../LLMS.md](../../LLMS.md)
+

rom_runtime-0.0.2/README.md

@@ -0,0 +1,74 @@
+# `rom-runtime`
+
+Python bindings for the ROM browser-like runtime.
+
+This package exposes a thin Python API on top of ROM:
+
+- `eval()`
+- `eval_async()`
+- `eval_json()`
+- `surface_snapshot()`
+- `fingerprint_probe()`
+- `run_fingerprintjs_harness()`
+- `fingerprintjs_version()`
+
+It prefers a native `PyO3` extension when available and falls back to the ROM CLI bridge otherwise.
+
+## Install
+
+```bash
+pip install rom-runtime
+```
+
+## Usage
+
+```python
+from rom import RomRuntime, has_native_binding
+
+runtime = RomRuntime(
+    {
+        "href": "https://example.test/",
+        "cors_enabled": False,
+        "proxy_url": None,
+    }
+)
+href = runtime.eval_async("(async () => location.href)()")
+snapshot = runtime.surface_snapshot()
+
+print("native:", has_native_binding())
+print(href)
+print(snapshot["fetch"])
+```
+
+Config keys use the Rust runtime field names, so use snake_case such as `cors_enabled` and `proxy_url`.
+`cors_enabled` is `False` by default.
+
+## Optional native build from source
+
+```bash
+python -m pip install maturin
+python -m maturin build --manifest-path bindings/gom-python/Cargo.toml --release
+```
+
+Tagged GitHub releases build and publish wheels for Linux, Windows, and macOS, plus an sdist for source installs.
+
+## Common methods
+
+- `eval()`
+- `eval_async()`
+- `eval_json()`
+- `surface_snapshot()`
+- `fingerprint_probe()`
+- `run_fingerprintjs_harness()`
+- `fingerprintjs_version()`
+
+## Environment
+
+- `ROM_FORCE_CLI_BRIDGE=1`: disable the native path and force CLI fallback
+- `ROM_BRIDGE_BIN`: explicit path to the `rom_bridge` executable
+- `ROM_BRIDGE_CWD`: working directory used by the CLI fallback
+
+## More docs
+
+- Root guide: [../../README.md](../../README.md)
+- LLM guide: [../../LLMS.md](../../LLMS.md)