soia-client 1.0.10__tar.gz → 1.0.12__tar.gz

{soia_client-1.0.10 → soia_client-1.0.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soia-client
-Version: 1.0.10
+Version: 1.0.12
 Author-email: Tyler Fibonacci <gepheum@gmail.com>
 License: MIT License
         

{soia_client-1.0.10 → soia_client-1.0.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "soia-client"
-version = "1.0.10"
+version = "1.0.12"
 description = ""
 readme = "README.md"
 authors = [{ name = "Tyler Fibonacci", email = "gepheum@gmail.com" }]

{soia_client-1.0.10 → soia_client-1.0.12}/soia_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soia-client
-Version: 1.0.10
+Version: 1.0.12
 Author-email: Tyler Fibonacci <gepheum@gmail.com>
 License: MIT License
         

{soia_client-1.0.10 → soia_client-1.0.12}/soia_client.egg-info/SOURCES.txt

@@ -5,13 +5,17 @@ soia_client.egg-info/PKG-INFO
 soia_client.egg-info/SOURCES.txt
 soia_client.egg-info/dependency_links.txt
 soia_client.egg-info/top_level.txt
+soialib/_.py
 soialib/__init__.py
 soialib/keyed_items.py
 soialib/method.py
 soialib/module_initializer.py
 soialib/never.py
+soialib/reflection.py
 soialib/serializer.py
 soialib/serializers.py
+soialib/service.py
+soialib/service_client.py
 soialib/spec.py
 soialib/timestamp.py
 soialib/impl/__init__.py

soia_client-1.0.12/soialib/_.py

@@ -0,0 +1,3 @@
+from typing import Any, Final
+
+_: Final[Any] = None

{soia_client-1.0.10 → soia_client-1.0.12}/soialib/__init__.py

@@ -6,12 +6,14 @@ from soialib.serializers import (
     optional_serializer,
     primitive_serializer,
 )
+from soialib.service_client import ServiceClient
 from soialib.timestamp import Timestamp
 
 __all__ = [
     "KeyedItems",
     "Method",
     "Serializer",
+    "ServiceClient",
     "Timestamp",
     "array_serializer",
     "optional_serializer",

{soia_client-1.0.10 → soia_client-1.0.12}/soialib/impl/arrays.py

@@ -3,6 +3,7 @@ from dataclasses import FrozenInstanceError
 from typing import Generic, Optional
 from weakref import WeakValueDictionary
 
+import soialib.reflection
 from soialib import spec
 from soialib.impl.function_maker import Any, Expr, ExprLike, Line, make_function
 from soialib.impl.type_adapter import TypeAdapter
@@ -18,7 +19,7 @@ def get_array_adapter(
         listuple_class = _new_keyed_items_class(key_attributes, default_expr)
     else:
         listuple_class = _new_listuple_class()
-    array_adapter = _ArrayAdapter(item_adapter, listuple_class)
+    array_adapter = _ArrayAdapter(item_adapter, listuple_class, key_attributes)
     return _item_to_array_adapter.setdefault(
         (item_adapter, key_attributes), array_adapter
     )
@@ -28,6 +29,7 @@ class _ArrayAdapter(TypeAdapter):
     __slots__ = (
         "item_adapter",
         "listuple_class",
+        "key_attributes",
         "empty_listuple",
     )
 
@@ -39,9 +41,11 @@ class _ArrayAdapter(TypeAdapter):
         self,
         item_adapter: TypeAdapter,
         listuple_class: type,
+        key_attributes: tuple[str, ...],
     ):
         self.item_adapter = item_adapter
         self.listuple_class = listuple_class
+        self.key_attributes = key_attributes
         self.empty_listuple = listuple_class()
 
     def default_expr(self) -> ExprLike:
@@ -104,6 +108,21 @@ class _ArrayAdapter(TypeAdapter):
     ) -> None:
         self.item_adapter.finalize(resolve_type_fn)
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.ArrayType(
+            kind="array",
+            value=soialib.reflection.ArrayType.Array(
+                item=self.item_adapter.get_type(),
+                key_chain=self.key_attributes,
+            ),
+        )
+
+    def register_records(
+        self,
+        registry: dict[str, soialib.reflection.Record],
+    ) -> None:
+        self.item_adapter.register_records(registry)
+
 
 _ItemAndKeyAttributes = tuple[TypeAdapter, tuple[str, ...]]
 _ItemToArrayAdapter = WeakValueDictionary[_ItemAndKeyAttributes, _ArrayAdapter]

{soia_client-1.0.10 → soia_client-1.0.12}/soialib/impl/enums.py

@@ -3,6 +3,7 @@ from collections.abc import Callable, Sequence
 from dataclasses import FrozenInstanceError, dataclass
 from typing import Any, Final, Union
 
+import soialib.reflection
 from soialib import spec as _spec
 from soialib.impl.function_maker import BodyBuilder, Expr, ExprLike, Line, make_function
 from soialib.impl.repr import repr_impl
@@ -15,6 +16,7 @@ class EnumAdapter(TypeAdapter):
         "gen_class",
         "private_is_enum_attr",
         "finalization_state",
+        "value_fields",
     )
 
     spec: Final[_spec.Enum]
@@ -22,6 +24,7 @@ class EnumAdapter(TypeAdapter):
     private_is_enum_attr: Final[str]
     # 0: has not started; 1: in progress; 2: done
     finalization_state: int
+    value_fields: tuple["_ValueField", ...]
 
     def __init__(self, spec: _spec.Enum):
         self.finalization_state = 0
@@ -51,10 +54,10 @@ class EnumAdapter(TypeAdapter):
         base_class = self.gen_class
 
         # Resolve the type of every value field.
-        value_fields = [
+        self.value_fields = value_fields = tuple(
             _make_value_field(f, resolve_type_fn(f.type), base_class)
             for f in self.spec.value_fields
-        ]
+        )
 
         # Aim to have dependencies finalized *before* the dependent. It's not always
         # possible, because there can be cyclic dependencies.
@@ -116,6 +119,35 @@ class EnumAdapter(TypeAdapter):
                 Expr.local("_cls?", self.gen_class), f".{fn_name}(", json_expr, ")"
             )
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.RecordType(
+            kind="record",
+            value=self.spec.id,
+        )
+
+    def register_records(
+        self,
+        registry: dict[str, soialib.reflection.Record],
+    ) -> None:
+        record_id = self.spec.id
+        if record_id in registry:
+            return
+        registry[record_id] = soialib.reflection.Record(
+            kind="enum",
+            id=record_id,
+            fields=tuple(
+                soialib.reflection.Field(
+                    name=field.spec.name,
+                    number=field.spec.number,
+                    type=field.field_type.get_type(),
+                )
+                for field in self.value_fields
+            ),
+            removed_fields=self.spec.removed_numbers,
+        )
+        for field in self.value_fields:
+            field.field_type.register_records(registry)
+
 
 def _make_base_class(spec: _spec.Enum) -> type:
     record_hash = hash(spec.id)

{soia_client-1.0.10 → soia_client-1.0.12}/soialib/impl/optionals.py

@@ -3,6 +3,7 @@ from dataclasses import dataclass
 from typing import TypeVar
 from weakref import WeakValueDictionary
 
+import soialib.reflection
 from soialib import spec
 from soialib.impl.function_maker import Expr, ExprLike
 from soialib.impl.type_adapter import TypeAdapter
@@ -67,6 +68,18 @@ class _OptionalAdapter(TypeAdapter):
     ) -> None:
         self.other_adapter.finalize(resolve_type_fn)
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.OptionalType(
+            kind="optional",
+            value=self.other_adapter.get_type(),
+        )
+
+    def register_records(
+        self,
+        registry: dict[str, soialib.reflection.Record],
+    ) -> None:
+        self.other_adapter.register_records(registry)
+
 
 _other_adapter_to_optional_adapter: WeakValueDictionary[TypeAdapter, TypeAdapter] = (
     WeakValueDictionary()

{soia_client-1.0.10 → soia_client-1.0.12}/soialib/impl/primitives.py

@@ -2,6 +2,7 @@ from collections.abc import Callable
 from dataclasses import dataclass
 from typing import Any, Final, final
 
+import soialib.reflection
 from soialib import spec
 from soialib.impl.function_maker import Expr, ExprLike
 from soialib.impl.type_adapter import TypeAdapter
@@ -16,6 +17,13 @@ class AbstractPrimitiveAdapter(TypeAdapter):
     ) -> None:
         pass
 
+    @final
+    def register_records(
+        self,
+        records: dict[str, soialib.reflection.Record],
+    ) -> None:
+        pass
+
 
 class _BoolAdapter(AbstractPrimitiveAdapter):
     def default_expr(self) -> ExprLike:
@@ -40,6 +48,12 @@ class _BoolAdapter(AbstractPrimitiveAdapter):
     def from_json_expr(self, json_expr: ExprLike) -> Expr:
         return Expr.join("(True if ", json_expr, " else False)")
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.PrimitiveType(
+            kind="primitive",
+            value="bool",
+        )
+
 
 BOOL_ADAPTER: Final[TypeAdapter] = _BoolAdapter()
 
@@ -80,6 +94,12 @@ class _Int32Adapter(_AbstractIntAdapter):
             " < 2147483647 else 2147483647)",
         )
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.PrimitiveType(
+            kind="primitive",
+            value="int32",
+        )
+
 
 def _int64_to_json(i: int) -> int | str:
     if i < -9007199254740991:  # min safe integer in JavaScript
@@ -100,6 +120,12 @@ class _Int64Adapter(_AbstractIntAdapter):
     def to_json_expr(self, in_expr: ExprLike, readable: bool) -> Expr:
         return Expr.join(Expr.local("int64_to_json", _int64_to_json), "(", in_expr, ")")
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.PrimitiveType(
+            kind="primitive",
+            value="int64",
+        )
+
 
 def _uint64_to_json(i: int) -> int | str:
     if i <= 0:
@@ -119,6 +145,12 @@ class _Uint64Adapter(_AbstractIntAdapter):
             Expr.local("uint64_to_json", _uint64_to_json), "(", in_expr, ")"
         )
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.PrimitiveType(
+            kind="primitive",
+            value="uint64",
+        )
+
 
 INT32_ADAPTER: Final[TypeAdapter] = _Int32Adapter()
 INT64_ADAPTER: Final[TypeAdapter] = _Int64Adapter()
@@ -149,11 +181,23 @@ class _AbstractFloatAdapter(AbstractPrimitiveAdapter):
 class _Float32Adapter(_AbstractFloatAdapter):
     """Type adapter implementation for float32."""
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.PrimitiveType(
+            kind="primitive",
+            value="float32",
+        )
+
 
 @dataclass(frozen=True)
 class _Float64Adapter(_AbstractFloatAdapter):
     """Type adapter implementation for float32."""
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.PrimitiveType(
+            kind="primitive",
+            value="float64",
+        )
+
 
 FLOAT32_ADAPTER: Final[TypeAdapter] = _Float32Adapter()
 FLOAT64_ADAPTER: Final[TypeAdapter] = _Float64Adapter()
@@ -192,6 +236,12 @@ class _TimestampAdapter(AbstractPrimitiveAdapter):
         fn = Expr.local("_timestamp_from_json", _timestamp_from_json)
         return Expr.join(fn, "(", json_expr, ")")
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.PrimitiveType(
+            kind="primitive",
+            value="timestamp",
+        )
+
 
 def _timestamp_from_json(json: Any) -> Timestamp:
     if json.__class__ is int or isinstance(json, int):
@@ -219,6 +269,12 @@ class _StringAdapter(AbstractPrimitiveAdapter):
     def from_json_expr(self, json_expr: ExprLike) -> Expr:
         return Expr.join("('' + (", json_expr, " or ''))")
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.PrimitiveType(
+            kind="primitive",
+            value="string",
+        )
+
 
 STRING_ADAPTER: Final[TypeAdapter] = _StringAdapter()
 
@@ -247,5 +303,11 @@ class _BytesAdapter(AbstractPrimitiveAdapter):
             Expr.local("fromhex", _BytesAdapter._fromhex_fn), "(", json_expr, ' or "")'
         )
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.PrimitiveType(
+            kind="primitive",
+            value="bytes",
+        )
+
 
 BYTES_ADAPTER: Final[TypeAdapter] = _BytesAdapter()

{soia_client-1.0.10 → soia_client-1.0.12}/soialib/impl/structs.py

@@ -3,6 +3,7 @@ from collections.abc import Callable, Sequence
 from dataclasses import FrozenInstanceError, dataclass
 from typing import Any, Final, Union, cast
 
+import soialib.reflection
 from soialib import spec as _spec
 from soialib.impl.function_maker import (
     BodyBuilder,
@@ -28,6 +29,7 @@ class StructAdapter(TypeAdapter):
         "simple_class",
         "private_is_frozen_attr",
         "finalization_state",
+        "fields",
     )
 
     spec: Final[_spec.Struct]
@@ -40,6 +42,7 @@ class StructAdapter(TypeAdapter):
 
     # 0: has not started; 1: in progress; 2: done
     finalization_state: int
+    fields: tuple["_Field", ...]
 
     def __init__(self, spec: _spec.Struct):
         self.finalization_state = 0
@@ -90,7 +93,7 @@ class StructAdapter(TypeAdapter):
         self.finalization_state = 1
 
         # Resolve the type of every field.
-        fields = tuple(
+        self.fields = fields = tuple(
             sorted(
                 (_Field(f, resolve_type_fn(f.type)) for f in self.spec.fields),
                 key=lambda f: f.field.number,
@@ -198,6 +201,35 @@ class StructAdapter(TypeAdapter):
                 Expr.local("_cls?", self.gen_class), f".{fn_name}(", json_expr, ")"
             )
 
+    def get_type(self) -> soialib.reflection.Type:
+        return soialib.reflection.RecordType(
+            kind="record",
+            value=self.spec.id,
+        )
+
+    def register_records(
+        self,
+        registry: dict[str, soialib.reflection.Record],
+    ) -> None:
+        record_id = self.spec.id
+        if record_id in registry:
+            return
+        registry[record_id] = soialib.reflection.Record(
+            kind="struct",
+            id=record_id,
+            fields=tuple(
+                soialib.reflection.Field(
+                    name=field.field.name,
+                    number=field.field.number,
+                    type=field.type.get_type(),
+                )
+                for field in self.fields
+            ),
+            removed_fields=self.spec.removed_numbers,
+        )
+        for field in self.fields:
+            field.type.register_records(registry)
+
 
 class _Frozen:
     def __setattr__(self, name: str, value: Any):

{soia_client-1.0.10 → soia_client-1.0.12}/soialib/impl/type_adapter.py

@@ -1,6 +1,7 @@
 from collections.abc import Callable
 from typing import Protocol
 
+import soialib.reflection
 from soialib import spec
 from soialib.impl.function_maker import ExprLike
 
@@ -53,3 +54,10 @@ class TypeAdapter(Protocol):
         self,
         resolve_type_fn: Callable[[spec.Type], "TypeAdapter"],
     ) -> None: ...
+
+    def get_type(self) -> soialib.reflection.Type: ...
+
+    def register_records(
+        self,
+        registry: dict[str, soialib.reflection.Record],
+    ) -> None: ...