docs: fix incorrect method names, defaults, and add missing documentation

- Fix asByteArray() -> asBytes() in basics.md and python-value.md
- Add missing methods to python-value.md (raw, isNull, asDoubleMap, asStringMap, etc.)
- Fix pool defaults (min: 2->1, max: 8->1), timeout defaults in spring-boot.md
- Add missing spring-boot properties (max-code-length, python-executable, warmup-scripts, lenient-warmup)
- Fix health check response to match actual PythonEmbedHealthIndicator output
- Fix requirements -> requirementsFile in installation.md
- Add Extension Properties table to installation.md
- Add datetime types to arg() supported list in python-embed.md and basics.md

Author: howtis

docs/api/python-embed.md

@@ -13,7 +13,7 @@ Creates a `PythonEmbed` with default options.
 Creates a `PythonEmbed` with the given options.
 
 ### `arg(Object value)`
-Converts a Java value to a safe Python literal string. Supports: `null`, `Boolean`, `Number`, `String`, `List`, `Set`, `Map`, `byte[]`, `Instant`.
+Converts a Java value to a safe Python literal string. Supports: `null`, `Boolean`, `Number`, `String`, `List`, `Set`, `Map`, `byte[]`, `Instant`, `LocalDateTime`, `LocalDate`, `LocalTime`, `ZonedDateTime`.
 
 ## Instance Methods
 

docs/api/python-value.md

@@ -15,8 +15,15 @@
 | `asList(Class<T>)` | `List<T>` | `list` | Convert to typed list |
 | `asMap()` | `Map<String, Object>` | `dict` | Convert to raw map |
 | `asMap(Class<K>, Class<V>)` | `Map<K, V>` | `dict` | Convert to typed map |
-| `asByteArray()` | `byte[]` | `bytes` | Convert to byte array |
+| `asBytes()` | `byte[]` | `bytes` | Convert to byte array |
 | `toJson()` | `String` | any | JSON string representation |
+| `toJson(boolean)` | `String` | any | JSON with optional pretty-print |
+| `raw()` | `Object` | any | Get raw Java object |
+| `isNull()` | `boolean` | `None` / `null` | Check if value is null |
+| `asDoubleMap()` | `Map<String, Double>` | `dict` | Number values as Double |
+| `asStringMap()` | `Map<String, String>` | `dict` | String values |
+| `asIntMap()` | `Map<String, Integer>` | `dict` | Integer values |
+| `asLongMap()` | `Map<String, Long>` | `dict` | Long values |
 
 ## Usage Examples
 
@@ -33,7 +40,7 @@ PythonValue dictVal = py.eval("{'a': 1, 'b': 2}");
 Map<String, Integer> map = dictVal.asMap(String.class, Integer.class);
 
 PythonValue bytesVal = py.eval("b'hello'");
-byte[] bytes = bytesVal.asByteArray();
+byte[] bytes = bytesVal.asBytes();
 
 // JSON serialization
 String json = py.eval("{'key': [1, 2, 3]}").toJson();
@@ -43,4 +50,6 @@ String json = py.eval("{'key': [1, 2, 3]}").toJson();
 
 - `asList()` without type parameter returns `List<Object>` — use the typed variant when possible
 - `asMap()` without type parameters returns `Map<String, Object>`
+- Convenience methods `asDoubleMap()`, `asStringMap()`, `asIntMap()`, `asLongMap()` avoid manual type casting
 - `toJson()` serializes the Python value to JSON for logging or transmission
+- `toJson(true)` enables pretty-printed output

docs/installation.md

@@ -25,7 +25,7 @@ pythonEmbed {
         'torch',
         'msgpack'
     ]
-    requirements = file('requirements.txt')  // alternative to packages
+    requirementsFile = 'requirements.txt'  // alternative to packages
 }
 ```
 
@@ -36,6 +36,19 @@ pythonEmbed {
 3. If not found → downloads [python-build-standalone](https://github.com/astral-sh/python-build-standalone) (~50 MB, cached) and installs packages directly
 4. Packages the venv as a JAR resource for runtime extraction
 
+### Extension Properties
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `packages` | `List<String>` | `[]` | Pip packages to install |
+| `requirementsFile` | `String` | — | Path to `requirements.txt` (relative to project root) |
+| `pyprojectTomlFile` | `String` | — | Path to `pyproject.toml` (relative to project root) |
+| `pythonVersion` | `String` | `3.12` | Python version (for python-build-standalone) |
+| `pipIndexUrl` | `String` | — | Custom pip index URL (e.g., PyTorch CUDA) |
+| `pipExtraArgs` | `List<String>` | `[]` | Extra pip install arguments (e.g., `-f`, `--extra-index-url`) |
+| `venvOutputDir` | `Directory` | `build/python-venv` | Output directory for the venv |
+| `targetOs` | `String` | auto-detected | Cross-compile for `windows`, `linux`, or `macos` |
+
 The venv is rebuilt incrementally — only when dependencies change.
 
 ## Spring Boot Starter

docs/spring-boot.md

@@ -90,24 +90,37 @@ management:
 
 Access at `/actuator/health`:
 
+**SINGLE mode:**
+
 ```json
 {
   "status": "UP",
   "components": {
     "pythonEmbed": {
       "status": "UP",
       "details": {
-        "pid": 12345,
-        "running": true,
-        "rssMB": 45.2,
+        "memoryRssKb": 46284,
         "refCount": 3,
-        "gcGen": 1,
-        "pool": {
-          "size": 3,
-          "active": 1,
-          "minPool": 2,
-          "maxPool": 8
-        }
+        "gcEnabled": true,
+        "gcCounts": [120, 5, 1]
+      }
+    }
+  }
+}
+```
+
+**POOL mode:**
+
+```json
+{
+  "status": "UP",
+  "components": {
+    "pythonEmbed": {
+      "status": "UP",
+      "details": {
+        "size": 3,
+        "minPool": 2,
+        "activeCount": 1
       }
     }
   }
@@ -120,11 +133,15 @@ Access at `/actuator/health`:
 |----------|------|---------|-------------|
 | `python-embed.mode` | `SINGLE` / `POOL` | `SINGLE` | Bean type to create |
 | `python-embed.venv-path` | `String` | auto-resolved | Override venv location |
-| `python-embed.pool.min` | `int` | 2 | Minimum pool size |
-| `python-embed.pool.max` | `int` | 8 | Maximum pool size |
+| `python-embed.pool.min` | `int` | 1 | Minimum pool size |
+| `python-embed.pool.max` | `int` | 1 | Maximum pool size |
 | `python-embed.pool.idle-timeout` | `Duration` | 60s | Idle instance removal |
 | `python-embed.pool.health-check-interval` | `Duration` | 30s | Health ping interval |
 | `python-embed.pool.close-timeout` | `Duration` | 30s | Graceful shutdown timeout |
-| `python-embed.options.timeout-ms` | `long` | 30000 | Per-request timeout |
-| `python-embed.options.startup-timeout-ms` | `long` | 10000 | Process startup timeout |
-| `python-embed.options.environment-vars` | `Map` | — | Environment variables |
+| `python-embed.options.timeout-ms` | `long` | 0 | Per-request timeout (0 = use PythonEmbed default: 30000) |
+| `python-embed.options.startup-timeout-ms` | `long` | 30000 | Process startup timeout |
+| `python-embed.options.max-code-length` | `int` | 100000 | Maximum code length in chars |
+| `python-embed.options.python-executable` | `String` | — | Override Python executable path |
+| `python-embed.options.warmup-scripts` | `List<String>` | — | Warmup scripts to run on startup |
+| `python-embed.options.lenient-warmup` | `boolean` | true | Log warmup failures instead of throwing |
+| `python-embed.options.environment-vars` | `Map` | — | Environment variables passed to Python process |

docs/usage/basics.md

@@ -54,7 +54,7 @@ try (PythonEmbed py = PythonEmbed.create()) {
 | `asString()` | `String` | `py.eval("'hi'").asString()` |
 | `asList(Class)` | `List<T>` | `py.eval("[1,2,3]").asList(Integer.class)` |
 | `asMap(K,V)` | `Map<K,V>` | `py.eval("{'a':1}").asMap(String.class, Integer.class)` |
-| `asByteArray()` | `byte[]` | `py.eval("b'\\x01\\x02'").asByteArray()` |
+| `asBytes()` | `byte[]` | `py.eval("b'\\x01\\x02'").asBytes()` |
 | `toJson()` | `String` | JSON representation |
 
 ## arg() — Safe Parameter Injection
@@ -71,6 +71,9 @@ PythonEmbed.arg(List.of(1, 2));   // [1, 2]
 PythonEmbed.arg(Set.of(1, 2));    // {1, 2}
 PythonEmbed.arg(Map.of("k", 1));  // {'k': 1}
 PythonEmbed.arg(new byte[]{1,2}); // b'\x01\x02'
+PythonEmbed.arg(LocalDateTime.now());       // datetime.datetime(2024, 1, 15, 10, 30, 0)
+PythonEmbed.arg(LocalDate.of(2024, 1, 15)); // datetime.date(2024, 1, 15)
+PythonEmbed.arg(Instant.now());             // datetime.datetime.fromtimestamp(...)
 
 // Safe — user input can't break out of the string literal:
 String userInput = "Bob'; import os; os.system('rm -rf /') #";