v8-python 0.1.0__cp313-cp313-win_amd64.whl

v8/__init__.py

@@ -0,0 +1,5 @@
+from .v8 import *
+
+__doc__ = v8.__doc__
+if hasattr(v8, "__all__"):
+    __all__ = v8.__all__

v8_python-0.1.0.dist-info/METADATA

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: v8-python
+Version: 0.1.0
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Summary: Python bindings for embedding V8 with denoland/rusty_v8.
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# v8-python
+
+Python bindings for embedding V8 and running JavaScript, built on
+`denoland/rusty_v8`.
+
+`v8-python` lets Python code create V8 isolates and contexts, evaluate
+JavaScript, pass values between Python and JavaScript, expose Python functions
+and classes to JavaScript, and install host APIs such as timers, console,
+module loading, and WebAssembly. It is implemented in Rust using
+`denoland/rusty_v8`.
+
+## Install
+
+```bash
+pip install v8-python
+```
+
+For local development:
+
+```bash
+uv run maturin develop
+```
+
+## Tutorial
+
+### Run JavaScript
+
+```python
+import v8
+
+isolate = v8.Isolate()
+builder = isolate.create_context_builder()
+context = builder.build()
+
+result = context.eval("'Hello' + ' from V8'")
+print(result)
+```
+
+### Expose a Python function
+
+```python
+import v8
+
+isolate = v8.Isolate()
+builder = isolate.create_context_builder()
+
+
+@builder.host_function(name="add")
+def add(left: int, right: int) -> int:
+    return left + right
+
+
+context = builder.build()
+print(context.eval("add(20, 22)"))
+```
+
+### Install host APIs
+
+Host APIs are installed through a profile. This keeps the context builder small
+and makes reusable runtime setups easy to share.
+
+```python
+import v8
+
+profile = v8.BaseProfile().install([v8.api.Timer()])
+
+isolate = v8.Isolate()
+builder = isolate.create_context_builder()
+builder.use_profile(profile)
+context = builder.build()
+
+context.eval(
+    """
+    globalThis.events = [];
+    setTimeout(() => events.push("ready"), 0);
+    """
+)
+
+context.run_until_idle(max_tasks=10)
+print(context.eval("events.join(', ')"))
+```
+
+### Await a JavaScript Promise
+
+JavaScript promises can be awaited from Python.
+
+```python
+import asyncio
+import v8
+
+isolate = v8.Isolate()
+builder = isolate.create_context_builder()
+context = builder.build()
+
+
+async def main():
+    return await context.eval("Promise.resolve('done')")
+
+
+print(asyncio.run(main()))
+```
+
+More focused examples are available in the `examples/` directory.
+
+## Documentation
+
+```bash
+uv run --group doc zensical serve
+```
+

v8_python-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+v8/__init__.py,sha256=QMcom8iHkz1leg33TjH_aqKE_1TCJiGF_nT-F6ce-To,91
+v8/v8.cp313-win_amd64.pyd,sha256=5urTGwKeZRVcx44xWrbEBmTnaL3-lTn2Tb8HvSpTWeQ,33169408
+v8_python-0.1.0.dist-info/METADATA,sha256=b1QwrxsTivXNlLFg7QQ4wOOG7anVTrP83UZKj3nbzE0,2815
+v8_python-0.1.0.dist-info/WHEEL,sha256=TDIE_VZkwaFwJY0Olvlg1LUe0IwzGBwZhAVXfIDdWJc,97
+v8_python-0.1.0.dist-info/sboms/v8-python.cyclonedx.json,sha256=oaDt2yFiN6fBLevsGgmJoUGKN0M2WUfJixW-wrRFcPs,177300
+v8_python-0.1.0.dist-info/RECORD,,

v8_python-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.13.1)
+Root-Is-Purelib: false
+Tag: cp313-cp313-win_amd64