positronic-model-server 0.2.2__tar.gz → 0.2.3__tar.gz

{positronic_model_server-0.2.2 → positronic_model_server-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: positronic-model-server
-Version: 0.2.2
+Version: 0.2.3
 Summary: Model serving, session lifecycle and serialization without Positronic dependencies
 License-Expression: Apache-2.0
 Requires-Python: >=3.11
@@ -22,9 +22,9 @@ The wrapper owns transport, sessions, serialization and cleanup. Vendor scripts
 model directly in the same process and describe the client pipeline as plain data.
 
 ```bash
-uv pip install "positronic-model-server==0.2.2"
-uv pip install "positronic-model-server[websocket]==0.2.2"
-uv pip install "positronic-model-server[grpc]==0.2.2"
+uv pip install "positronic-model-server==0.2.3"
+uv pip install "positronic-model-server[websocket]==0.2.3"
+uv pip install "positronic-model-server[grpc]==0.2.3"
 ```
 
 The core depends on NumPy, Pillow, msgpack and `positronic-wire`'s dependency-free transport
@@ -45,7 +45,7 @@ from positronic_model_server.websocket_wire import WebsocketWire
 
 class EchoSession(Session):
     def __init__(self, fps):
-        super().__init__(component("chunked_schedule", version=2, fps=fps))
+        super().__init__(component("chunked_schedule", fps=fps))
 
     def infer(self, observation):
         return [observation]
@@ -137,7 +137,7 @@ and instantiates their implementations:
 from positronic_model_server.spec import component, parallel, sequence
 
 description = sequence(
-    component("chunked_schedule", version=2, fps=20),
+    component("chunked_schedule", fps=20),
     parallel(
         component("restrict_image_size", width=320, height=180),
         component("metadata", values={"model": "example"}),
@@ -145,9 +145,12 @@ description = sequence(
 )
 ```
 
-`component` accepts a name, explicit version and keyword arguments, normalizing arguments through
-JSON. `sequence` and `parallel` reject empty compositions. Component names and argument meanings
-belong to the client registry; these helpers do not resolve classes or validate model parameters.
+`component` accepts a name and JSON-compatible keyword arguments. By default it writes `version="latest"`,
+which selects the client's latest supported version. This can change after a client upgrade;
+pass `version=2`, for example, to pin a specific version. Legacy descriptions without a version mean v1.
+
+`sequence` and `parallel` reject empty compositions. The helpers check description structure;
+the client checks component names, supported versions and arguments when it builds the pipeline.
 The structural keys (`NAME`, `VERSION`, `ARGS`, `SEQ`, `PAR`) have one definition in `spec`.
 
 The wrapper defines only constants used by its own production code. Vendor settings belong to small

{positronic_model_server-0.2.2 → positronic_model_server-0.2.3}/README.md

@@ -5,9 +5,9 @@ The wrapper owns transport, sessions, serialization and cleanup. Vendor scripts
 model directly in the same process and describe the client pipeline as plain data.
 
 ```bash
-uv pip install "positronic-model-server==0.2.2"
-uv pip install "positronic-model-server[websocket]==0.2.2"
-uv pip install "positronic-model-server[grpc]==0.2.2"
+uv pip install "positronic-model-server==0.2.3"
+uv pip install "positronic-model-server[websocket]==0.2.3"
+uv pip install "positronic-model-server[grpc]==0.2.3"
 ```
 
 The core depends on NumPy, Pillow, msgpack and `positronic-wire`'s dependency-free transport
@@ -28,7 +28,7 @@ from positronic_model_server.websocket_wire import WebsocketWire
 
 class EchoSession(Session):
     def __init__(self, fps):
-        super().__init__(component("chunked_schedule", version=2, fps=fps))
+        super().__init__(component("chunked_schedule", fps=fps))
 
     def infer(self, observation):
         return [observation]
@@ -120,7 +120,7 @@ and instantiates their implementations:
 from positronic_model_server.spec import component, parallel, sequence
 
 description = sequence(
-    component("chunked_schedule", version=2, fps=20),
+    component("chunked_schedule", fps=20),
     parallel(
         component("restrict_image_size", width=320, height=180),
         component("metadata", values={"model": "example"}),
@@ -128,9 +128,12 @@ description = sequence(
 )
 ```
 
-`component` accepts a name, explicit version and keyword arguments, normalizing arguments through
-JSON. `sequence` and `parallel` reject empty compositions. Component names and argument meanings
-belong to the client registry; these helpers do not resolve classes or validate model parameters.
+`component` accepts a name and JSON-compatible keyword arguments. By default it writes `version="latest"`,
+which selects the client's latest supported version. This can change after a client upgrade;
+pass `version=2`, for example, to pin a specific version. Legacy descriptions without a version mean v1.
+
+`sequence` and `parallel` reject empty compositions. The helpers check description structure;
+the client checks component names, supported versions and arguments when it builds the pipeline.
 The structural keys (`NAME`, `VERSION`, `ARGS`, `SEQ`, `PAR`) have one definition in `spec`.
 
 The wrapper defines only constants used by its own production code. Vendor settings belong to small

{positronic_model_server-0.2.2 → positronic_model_server-0.2.3}/positronic_model_server/spec.py

@@ -2,7 +2,7 @@
 
 import json
 from collections.abc import Sequence
-from typing import Any
+from typing import Any, Literal
 
 SEQ = 'seq'
 PAR = 'par'
@@ -10,13 +10,15 @@ NAME = 'name'
 ARGS = 'args'
 VERSION = 'version'
 
+LATEST: Literal['latest'] = 'latest'
 
-def component(name: str, /, *, version: int = 1, **args: Any) -> dict[str, Any]:
-    """Describe a component without importing it; arguments must survive a JSON round trip."""
+
+def component(name: str, /, *, version: int | Literal['latest'] = LATEST, **args: Any) -> dict[str, Any]:
+    """Describe a component, requesting the client's latest supported version unless pinned."""
     if not isinstance(name, str) or not name:
         raise ValueError('A component needs a nonempty name')
-    if type(version) is not int or version < 1:
-        raise ValueError('A component version must be a positive integer')
+    if version != LATEST and (type(version) is not int or version < 1):
+        raise ValueError('A component version must be a positive integer or "latest"')
     # JSON normalizes tuples to lists and rejects Python objects and nonfinite numbers.
     return {NAME: name, VERSION: version, ARGS: json.loads(json.dumps(args, allow_nan=False))}
 

{positronic_model_server-0.2.2 → positronic_model_server-0.2.3}/positronic_model_server/tests/test_spec.py

@@ -5,6 +5,7 @@ import json
 import pytest
 from positronic_model_server.spec import (
     ARGS,
+    LATEST,
     NAME,
     PAR,
     SEQ,
@@ -23,11 +24,29 @@ def test_composition_uses_the_client_wire_format():
     assert json.loads(json.dumps(spec)) == {
         'seq': [
             {'name': 'scheduler', 'version': 2, 'args': {'fps': 20}},
-            {'par': [{'name': 'left', 'version': 1, 'args': {}}, {'name': 'right', 'version': 1, 'args': {}}]},
+            {
+                'par': [
+                    {'name': 'left', 'version': 'latest', 'args': {}},
+                    {'name': 'right', 'version': 'latest', 'args': {}},
+                ]
+            },
         ]
     }
 
 
+def test_omitted_versions_request_latest():
+    saved = json.loads(json.dumps(component('vendor-owned')))
+    validate(saved)
+    assert saved[VERSION] == LATEST
+
+
+@pytest.mark.parametrize('version', [LATEST, 1, 17])
+def test_explicit_versions_survive_json_and_validation(version):
+    saved = json.loads(json.dumps(component('vendor-owned', version=version)))
+    validate(saved)
+    assert saved[VERSION] == version
+
+
 def test_arguments_are_normalized_to_json():
     arguments = {'offsets': (-0.1, 0), 'nested': {'values': [1, None, True]}}
     spec = component('vendor-owned', **arguments)
@@ -42,7 +61,7 @@ def test_non_json_arguments_fail_at_construction(value):
         component('vendor-owned', value=value)
 
 
-@pytest.mark.parametrize('version', [0, -1, True, '1'])
+@pytest.mark.parametrize('version', [0, -1, True, '1', 'newest', None])
 def test_invalid_versions_are_rejected(version):
     with pytest.raises(ValueError, match='positive integer'):
         component('vendor-owned', version=version)
@@ -62,6 +81,7 @@ def test_empty_composition_is_rejected(compose):
         {PAR: []},
         {SEQ: [component('x')], NAME: 'x'},
         {NAME: 'x', VERSION: False},
+        {NAME: 'chunked_schedule', VERSION: None},
         {NAME: 'x', ARGS: []},
         {NAME: 'x', ARGS: {'value': float('nan')}},
     ],
@@ -75,6 +95,12 @@ def test_structural_validation_does_not_need_a_component_registry():
     validate(sequence(component('unknown-vendor-component', version=17), parallel(component('another'))))
 
 
+def test_validation_preserves_unversioned_wire_descriptions():
+    node = {NAME: 'chunked_schedule', ARGS: {'fps': 20}}
+    validate(node)
+    assert VERSION not in node
+
+
 def test_parameter_resolution_refuses_unknown_names_and_copies_defaults():
     defaults = {'options': {'steps': [1, 2]}, 'fps': 20}
     effective = resolve_params(defaults, {'fps': 10})

{positronic_model_server-0.2.2 → positronic_model_server-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "positronic-model-server"
-version = "0.2.2"
+version = "0.2.3"
 description = "Model serving, session lifecycle and serialization without Positronic dependencies"
 readme = "README.md"
 requires-python = ">=3.11"