concurrent-c-node 0.2.0__tar.gz → 0.2.1__tar.gz

{concurrent_c_node-0.2.0 → concurrent_c_node-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: concurrent-c-node
-Version: 0.2.0
+Version: 0.2.1
 Summary: JavaScript and npm packages from Python over the Concurrent-C bridge: one spawned Node child per domain, host-controlled lifetime.
 License: MIT
 Project-URL: Repository, https://github.com/sreekotay/concurrent-c
@@ -40,9 +40,11 @@ array in **9ms** where the same values as a JSON list take 583ms.
 
 ```
 pip install concurrent-c-node   # needs node on PATH (or point at one)
+python -m cc_node.examples.use_node
+python -m cc_node.examples.bench_wire
 ```
 
-Import stays `import cc_node`. The mirror of
+Import stays `import cc_node`. Examples ship in the wheel. The mirror of
 [`concurrent-c-python`](https://github.com/sreekotay/concurrent-c/tree/main/npm/cc-python)
 — same domain model, same materialization rules, pointed the other way:
 
@@ -119,7 +121,8 @@ next to your program is the whole setup.
 
 ## Measured
 
-From [`examples/bench_wire.py`](https://github.com/sreekotay/concurrent-c/blob/main/pypi/cc-node/examples/bench_wire.py)
+From `python -m cc_node.examples.bench_wire` (sources under
+[`cc_node/examples/`](https://github.com/sreekotay/concurrent-c/blob/main/pypi/cc-node/cc_node/examples/))
 on a 4-vCPU x86-64 box, node 22 / python 3.11 (dated baselines under
 `perf/baselines/` in the repo):
 
@@ -138,7 +141,7 @@ future work.
 
 A worked tour (builtin Node modules, chains, callbacks, thenables,
 buffers — no npm install needed):
-[`examples/use_node.py`](https://github.com/sreekotay/concurrent-c/blob/main/pypi/cc-node/examples/use_node.py).
+`python -m cc_node.examples.use_node`.
 
 And when the hot path is YOUR code rather than an npm package, skip the
 wire entirely: a page of Concurrent-C (or C) exports as a native module

{concurrent_c_node-0.2.0 → concurrent_c_node-0.2.1}/README.md

@@ -29,9 +29,11 @@ array in **9ms** where the same values as a JSON list take 583ms.
 
 ```
 pip install concurrent-c-node   # needs node on PATH (or point at one)
+python -m cc_node.examples.use_node
+python -m cc_node.examples.bench_wire
 ```
 
-Import stays `import cc_node`. The mirror of
+Import stays `import cc_node`. Examples ship in the wheel. The mirror of
 [`concurrent-c-python`](https://github.com/sreekotay/concurrent-c/tree/main/npm/cc-python)
 — same domain model, same materialization rules, pointed the other way:
 
@@ -108,7 +110,8 @@ next to your program is the whole setup.
 
 ## Measured
 
-From [`examples/bench_wire.py`](https://github.com/sreekotay/concurrent-c/blob/main/pypi/cc-node/examples/bench_wire.py)
+From `python -m cc_node.examples.bench_wire` (sources under
+[`cc_node/examples/`](https://github.com/sreekotay/concurrent-c/blob/main/pypi/cc-node/cc_node/examples/))
 on a 4-vCPU x86-64 box, node 22 / python 3.11 (dated baselines under
 `perf/baselines/` in the repo):
 
@@ -127,7 +130,7 @@ future work.
 
 A worked tour (builtin Node modules, chains, callbacks, thenables,
 buffers — no npm install needed):
-[`examples/use_node.py`](https://github.com/sreekotay/concurrent-c/blob/main/pypi/cc-node/examples/use_node.py).
+`python -m cc_node.examples.use_node`.
 
 And when the hot path is YOUR code rather than an npm package, skip the
 wire entirely: a page of Concurrent-C (or C) exports as a native module

concurrent_c_node-0.2.1/cc_node/examples/bench_wire.py

@@ -0,0 +1,47 @@
+"""The cc-node wire, measured.  RESULT lines are machine-comparable.
+
+    python -m cc_node.examples.bench_wire
+"""
+import array
+import time
+
+import cc_node
+
+t0 = time.perf_counter()
+js = cc_node.create()
+js.eval("1")
+print("RESULT spawn_ms %d" % round((time.perf_counter() - t0) * 1000))
+
+f = js.eval("(x) => x")
+f(1)
+t0 = time.perf_counter()
+for i in range(500):
+    f(i)
+print("RESULT rtt_us %d" % round((time.perf_counter() - t0) / 500 * 1e6))
+
+g = js.eval("(cb) => cb(21) * 2")
+g(lambda x: x + 1)
+t0 = time.perf_counter()
+for _ in range(200):
+    g(lambda x: x + 1)
+print("RESULT callback_roundtrip_us %d"
+      % round((time.perf_counter() - t0) / 200 * 1e6))
+
+big = array.array("d", [float(i % 97) for i in range(1 << 20)])  # 8MB
+ln = js.eval("(a) => a.length")
+ln(big)
+t0 = time.perf_counter()
+for _ in range(10):
+    ln(big)
+print("RESULT bulk_8mb_shm_ms %.1f" % ((time.perf_counter() - t0) / 10 * 1000))
+
+biglist = [float(i % 97) for i in range(1 << 20)]
+ln(biglist)
+t0 = time.perf_counter()
+for _ in range(3):
+    ln(biglist)
+print("RESULT bulk_8mb_json_list_ms %d"
+      % round((time.perf_counter() - t0) / 3 * 1000))
+
+js.destroy()
+print("done")

concurrent_c_node-0.2.1/cc_node/examples/use_node.py

@@ -0,0 +1,32 @@
+"""cc-node in one sitting: builtin Node modules (no npm install needed),
+chains, callbacks both ways, and async-for-free.
+
+    python -m cc_node.examples.use_node
+"""
+import cc_node
+
+with cc_node.create() as js:
+    # Builtin modules: attribute access is property lookup, calls are calls.
+    path = js.require("path")
+    print("join      :", path.join("a", "b", "c.txt"))
+
+    crypto = js.require("crypto")
+    print("sha256    :", crypto.createHash("sha256")
+                               .update("cc-node").digest("hex")[:16], "...")
+
+    # eval for a quick lambda; a Python callable crosses as a JS function
+    # (JS conventions apply: Array.map passes value, index, array).
+    mapped = js.eval("(f) => [1, 2, 3].map(f)")(lambda x, *rest: x * 10)
+    print("callback  :", mapped)
+
+    # Async is free: thenables are awaited in the child before the reply.
+    fetchish = js.eval("async (x) => { return { doubled: x * 2 } }")
+    print("thenable  :", fetchish(21))
+
+    # Typed buffers cross as typed arrays (big ones via shared memory);
+    # results come back as numpy arrays when numpy is installed.
+    total = js.eval("(a) => a.reduce((s, x) => s + x, 0)")
+    import array
+    print("buffer sum:", total(array.array("d", [1.5, 2.5, 3.0])))
+
+    print("handles   :", js.stats())

{concurrent_c_node-0.2.0 → concurrent_c_node-0.2.1}/concurrent_c_node.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: concurrent-c-node
-Version: 0.2.0
+Version: 0.2.1
 Summary: JavaScript and npm packages from Python over the Concurrent-C bridge: one spawned Node child per domain, host-controlled lifetime.
 License: MIT
 Project-URL: Repository, https://github.com/sreekotay/concurrent-c
@@ -40,9 +40,11 @@ array in **9ms** where the same values as a JSON list take 583ms.
 
 ```
 pip install concurrent-c-node   # needs node on PATH (or point at one)
+python -m cc_node.examples.use_node
+python -m cc_node.examples.bench_wire
 ```
 
-Import stays `import cc_node`. The mirror of
+Import stays `import cc_node`. Examples ship in the wheel. The mirror of
 [`concurrent-c-python`](https://github.com/sreekotay/concurrent-c/tree/main/npm/cc-python)
 — same domain model, same materialization rules, pointed the other way:
 
@@ -119,7 +121,8 @@ next to your program is the whole setup.
 
 ## Measured
 
-From [`examples/bench_wire.py`](https://github.com/sreekotay/concurrent-c/blob/main/pypi/cc-node/examples/bench_wire.py)
+From `python -m cc_node.examples.bench_wire` (sources under
+[`cc_node/examples/`](https://github.com/sreekotay/concurrent-c/blob/main/pypi/cc-node/cc_node/examples/))
 on a 4-vCPU x86-64 box, node 22 / python 3.11 (dated baselines under
 `perf/baselines/` in the repo):
 
@@ -138,7 +141,7 @@ future work.
 
 A worked tour (builtin Node modules, chains, callbacks, thenables,
 buffers — no npm install needed):
-[`examples/use_node.py`](https://github.com/sreekotay/concurrent-c/blob/main/pypi/cc-node/examples/use_node.py).
+`python -m cc_node.examples.use_node`.
 
 And when the hot path is YOUR code rather than an npm package, skip the
 wire entirely: a page of Concurrent-C (or C) exports as a native module

{concurrent_c_node-0.2.0 → concurrent_c_node-0.2.1}/concurrent_c_node.egg-info/SOURCES.txt

@@ -2,6 +2,9 @@ README.md
 pyproject.toml
 cc_node/__init__.py
 cc_node/broker.cjs
+cc_node/examples/__init__.py
+cc_node/examples/bench_wire.py
+cc_node/examples/use_node.py
 concurrent_c_node.egg-info/PKG-INFO
 concurrent_c_node.egg-info/SOURCES.txt
 concurrent_c_node.egg-info/dependency_links.txt

{concurrent_c_node-0.2.0 → concurrent_c_node-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "concurrent-c-node"
-version = "0.2.0"
+version = "0.2.1"
 description = "JavaScript and npm packages from Python over the Concurrent-C bridge: one spawned Node child per domain, host-controlled lifetime."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -16,7 +16,8 @@ Repository = "https://github.com/sreekotay/concurrent-c"
 Documentation = "https://github.com/sreekotay/concurrent-c/blob/main/pypi/cc-node/README.md"
 
 [tool.setuptools]
-packages = ["cc_node"]
+packages = ["cc_node", "cc_node.examples"]
 
 [tool.setuptools.package-data]
 cc_node = ["broker.cjs"]
+"cc_node.examples" = ["*.py"]