Skip to content

Commit f11ea25

Browse files
committed
docs: remove unmeasured performance claims and library comparisons
Remove all 2-5x/10-20x speed claims, Jython/GraalPy comparison table, and other unverified metrics from mkdocs documentation.
1 parent e35d6cb commit f11ea25

4 files changed

Lines changed: 2 additions & 12 deletions

File tree

docs/architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ All communication happens via **MessagePack** binary protocol over stdin/stdout:
3737
| JSON | ~120 bytes | Medium | Built-in |
3838
| Pickle | ~40 bytes | Fast | Built-in (unsafe) |
3939

40-
MessagePack is 2-5× faster than JSON for typical workloads and produces smaller payloads. Pickle is faster but not safe for cross-process communication.
40+
MessagePack provides a compact binary format with strong typing, making it well-suited for cross-process communication over stdin/stdout.
4141

4242
## Process Lifecycle
4343

docs/examples/batch-operations.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,6 @@ Demonstrates batch evaluation and execution — sending multiple requests in a s
1010
- `batchExec()` executes multiple statements in one round-trip
1111
- Pool batch operations return `CompletableFuture<List<PythonValue>>`
1212
- Timeout applies to the entire batch, not per-item
13-
- 10-20× faster than sequential `eval()` for many small operations
1413

1514
## Run It
1615

docs/index.md

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,6 @@ Run Python code from Java — with full CPython compatibility and zero setup.
44

55
PythonEmbed embeds a real CPython interpreter in your JVM application via a subprocess + [MessagePack](https://msgpack.org/) binary protocol — just pure Java and CPython. All C extensions (numpy, scipy, torch) work out of the box.
66

7-
## Why PythonEmbed?
8-
9-
| Concern | PythonEmbed | Jython/GraalPy |
10-
|---------|------------|----------------|
11-
| CPython compatibility | Full — numpy, scipy, torch, all C extensions | Limited to pure Python |
12-
| Crash isolation | Python segfaults never kill the JVM | Native crash kills the JVM |
13-
| Setup | One Gradle plugin line | Manual venv or JVM flag configuration |
14-
| Performance | MessagePack binary protocol, 2–5× faster than JSON | In-process (JNI-based) |
15-
167
## Quick Look
178

189
Add the Gradle plugin:

docs/usage/batch.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Each `eval()`/`exec()` call involves:
4444
3. Read from stdout
4545
4. Deserialize response (MessagePack)
4646

47-
Batch operations combine all requests into one MessagePack frame, eliminating N-1 round-trips. For many small evaluations, this can be **10-20× faster**.
47+
Batch operations combine all requests into one MessagePack frame, eliminating N-1 round-trips.
4848

4949
## Batch with Pool
5050

0 commit comments

Comments
 (0)