UncountablePythonSDK 0.0.172__tar.gz → 0.0.173__tar.gz

{uncountablepythonsdk-0.0.172/UncountablePythonSDK.egg-info → uncountablepythonsdk-0.0.173}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UncountablePythonSDK
-Version: 0.0.172
+Version: 0.0.173
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173/UncountablePythonSDK.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UncountablePythonSDK
-Version: 0.0.172
+Version: 0.0.173
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/docs/requirements.txt

@@ -1,5 +1,5 @@
 furo==2025.12.19
-myst-parser==5.0.0
+myst-parser==5.1.0
 sphinx-autoapi==3.8.0
 sphinx-copybutton==0.5.2
 Sphinx==9.1.0

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/pkgs/argument_parser/parser_inner.py

@@ -136,7 +136,7 @@ def _build_parser_discriminated_union(
 ) -> ParserFunction[T]:
     discriminator = (
         snake_to_camel_case(discriminator_raw)
-        if context.options.from_camel_case
+        if context.options.is_api_encoding
         else discriminator_raw
     )
 
@@ -318,7 +318,7 @@ def build_parser_inner(
             field_name: field_parser(
                 value.get(
                     snake_to_camel_case(field_name)
-                    if context.options.from_camel_case
+                    if context.options.is_api_encoding
                     else field_name
                 )
             )
@@ -403,7 +403,7 @@ def build_parser_inner(
                 # enum keys and OpaqueData's would also have string value types,
                 # but their explicit type is not a string, thus shouldn't be converted
                 and args[0] is str
-                and context.options.from_camel_case
+                and context.options.is_api_encoding
             ):
                 return camel_to_snake_case(value)
             return inner
@@ -574,14 +574,18 @@ def _build_parser_dataclass(
     serial_class_data = get_serial_class_data(parsed_type)
 
     def resolve_serialized_field_name(*, field_name: str) -> str:
-        return (
-            snake_to_camel_case(field_name)
-            if (
-                context.options.from_camel_case
-                and not serial_class_data.has_unconverted_key(field_name)
-            )
-            else field_name
-        )
+        if context.options.is_api_encoding:
+            emit_api_override = serial_class_data.get_emit_api_override(field_name)
+            if emit_api_override is not None:
+                assert not serial_class_data.has_unconverted_key(field_name), (
+                    f"serial class field {field_name!r} appears in both "
+                    "emit_api_overrides and unconverted_keys; the features cannot "
+                    "be combined"
+                )
+                return emit_api_override
+            if not serial_class_data.has_unconverted_key(field_name):
+                return snake_to_camel_case(field_name)
+        return field_name
 
     def parse(value: typing.Any) -> typing.Any:
         # Use an exact type match to prevent base/derived class mismatches

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/pkgs/argument_parser/parser_options.py

@@ -33,7 +33,7 @@ class ParserOptions:
         )
 
     @property
-    def from_camel_case(self) -> bool:
+    def is_api_encoding(self) -> bool:
         return self.encoding == SourceEncoding.API
 
     @property

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/pkgs/serialization/serial_class.py

@@ -16,6 +16,7 @@ class _SerialClassData(SerialBase):
     unconverted_values: set[str] = dataclasses.field(default_factory=set)
     to_string_values: set[str] = dataclasses.field(default_factory=set)
     parse_require: set[str] = dataclasses.field(default_factory=set)
+    emit_api_overrides: dict[str, str] = dataclasses.field(default_factory=dict)
     named_type_path: str | None = None
 
 
@@ -28,6 +29,7 @@ def serial_class(
     unconverted_values: set[str] | None = None,
     to_string_values: set[str] | None = None,
     parse_require: set[str] | None = None,
+    emit_api_overrides: dict[str, str] | None = None,
     named_type_path: str | None = None,
     is_dynamic_allowed: bool = False,
 ) -> Callable[[ClassT], ClassT]:
@@ -50,6 +52,13 @@ def serial_class(
         This field is always required while parsing, even if it has a default in the definition.
         This allows supporting literal type defaults for Python instantiation, but
         requiring them for the API input.
+    @param emit_api_overrides
+        Maps Python field name -> the API JSON key used in serialization
+        and parsing. Lets a property carry a specific, potentially non-
+        standard, name on the API boundary; the Python field name and
+        storage encoding are unaffected. Replaces the default camelCase
+        conversion. Cannot be combined with `unconverted_keys` for the
+        same field; doing so raises at parse and serialize time.
     @param named_type_path
         The type_spec type-path to this type. This applies only to named types.
     """
@@ -60,6 +69,7 @@ def serial_class(
             unconverted_values=unconverted_values or set(),
             to_string_values=to_string_values or set(),
             parse_require=parse_require or set(),
+            emit_api_overrides=emit_api_overrides or {},
             named_type_path=named_type_path,
             from_decorator=True,
             is_dynamic_allowed=is_dynamic_allowed,
@@ -90,6 +100,9 @@ class SerialClassDataInspector(SerialInspector[ClassT]):
     def has_parse_require(self, key: str) -> bool:
         return key in self.current.parse_require
 
+    def get_emit_api_override(self, key: str) -> str | None:
+        return self.current.emit_api_overrides.get(key)
+
 
 def get_merged_serial_class_data(
     type_class: SerialType[Any],
@@ -119,6 +132,10 @@ def get_merged_serial_class_data(
                     | curr_base_class_data.to_string_values,
                     parse_require=base_class_data.parse_require
                     | curr_base_class_data.parse_require,
+                    emit_api_overrides={
+                        **curr_base_class_data.emit_api_overrides,
+                        **base_class_data.emit_api_overrides,
+                    },
                 )
     return base_class_data
 

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/pkgs/serialization_util/serialization_helpers.py

@@ -131,7 +131,14 @@ def _get_dataclass_conversion_lookups(dataclass_type: Any) -> DataclassConversio
 
     for field in dataclasses.fields(dataclass_type):
         key = field.name
-        if scd.has_unconverted_key(key):
+        emit_api_override = scd.get_emit_api_override(key)
+        if emit_api_override is not None:
+            assert not scd.has_unconverted_key(key), (
+                f"serial class field {key!r} appears in both emit_api_overrides "
+                "and unconverted_keys; the features cannot be combined"
+            )
+            key_conversions[key] = emit_api_override
+        elif scd.has_unconverted_key(key):
             key_conversions[key] = key
         else:
             key_conversions[key] = key_convert_to_camelcase(key)

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/pkgs/type_spec/builder.py

@@ -66,6 +66,11 @@ class SpecProperty:
     convert_value: PropertyConvertValue
     # Conversion of this property's name
     name_case: NameCase
+    # Pins the name used for this property in API emission to this exact
+    # string. The JSON key on the API boundary and the TypeScript field
+    # name both use this value verbatim. The Python field name and storage
+    # encoding are unaffected.
+    emit_api: str | None = None
     default: Any = None
     has_default: bool = False
     # Requires this value in parsing, even if it has a default
@@ -368,6 +373,7 @@ class SpecTypeDefn(SpecType):
                 "convert_value",
                 "default",
                 "desc",
+                "emit_api",
                 "ext_info",
                 "extant",
                 "label",
@@ -395,6 +401,21 @@ class SpecTypeDefn(SpecType):
             if name_case_raw is not None:
                 property_name_case = NameCase(name_case_raw)
 
+            emit_api = data.get("emit_api")
+            if emit_api is not None:
+                builder.ensure(
+                    isinstance(emit_api, str) and emit_api != "",
+                    f"emit_api must be a non-empty string for property {name}",
+                )
+                builder.ensure(
+                    util.is_valid_property_name(name),
+                    f"emit_api requires a snake_case property name; got {name}",
+                )
+                builder.ensure(
+                    property_name_case != NameCase.preserve,
+                    f"emit_api cannot be combined with name_case: preserve on property {name}",
+                )
+
             if property_name_case != NameCase.preserve:
                 assert util.is_valid_property_name(name), (
                     f"{name} is not a valid property name"
@@ -447,6 +468,7 @@ class SpecTypeDefn(SpecType):
                 spec_type=ptype,
                 convert_value=convert_value,
                 name_case=property_name_case,
+                emit_api=emit_api,
                 has_default=has_default,
                 default=default,
                 parse_require=parse_require,

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/pkgs/type_spec/emit_io_ts.py

@@ -4,7 +4,7 @@ from .emit_typescript_util import (
     MODIFY_NOTICE,
     EmitTypescriptContext,
     resolve_namespace_ref,
-    ts_name,
+    ts_property_name,
 )
 
 base_name_map_io_ts = {
@@ -70,7 +70,7 @@ def _emit_type_io_ts_impl(ctx: EmitTypescriptContext, stype: builder.SpecType) -
         missable_lines = []
         for prop in stype.properties.values():
             ref_type = refer_to_io_ts(ctx, prop.spec_type)
-            prop_name = ts_name(prop.name, stype.name_case)
+            prop_name = ts_property_name(prop, stype.name_case)
             if prop.extant == builder.PropertyExtant.missing:
                 # Unlike optional below, missing does not imply null is possible. They
                 # treated distinctly.

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/pkgs/type_spec/emit_open_api.py

@@ -32,7 +32,7 @@ from .emit_open_api_util import (
     TagPathsToRef,
     resolve_namespace_ref,
 )
-from .emit_typescript_util import ts_name
+from .emit_typescript_util import ts_name, ts_property_name
 from .open_api_util import (
     OpenAPIArrayType,
     OpenAPIBooleanT,
@@ -580,7 +580,7 @@ def _emit_type(
 
         for prop in stype.properties.values():
             ref_type = open_api_type(ctx, prop.spec_type, config=config)
-            prop_name = ts_name(prop.name, prop.name_case or stype.name_case)
+            prop_name = ts_property_name(prop, prop.name_case or stype.name_case)
             if prop.desc:
                 property_desc[prop_name] = prop.desc
             if prop.has_default and not prop.parse_require:

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/pkgs/type_spec/emit_python.py

@@ -808,6 +808,7 @@ class EmittedPropertiesMetadata:
     unconverted_values: set[str]
     to_string_values: set[str]
     parse_require: set[str]
+    emit_api_overrides: dict[str, str]
 
 
 def _emit_type_properties(
@@ -839,6 +840,7 @@ def _emit_properties(
     unconverted_values: set[str] = set()
     to_string_values: set[str] = set()
     parse_require: set[str] = set()
+    emit_api_overrides: dict[str, str] = {}
 
     if len(properties) > 0:
 
@@ -848,6 +850,9 @@ def _emit_properties(
                 unconverted_keys.add(prop.name)
             py_name = python_field_name(prop.name, prop.name_case)
 
+            if prop.emit_api is not None:
+                emit_api_overrides[py_name] = prop.emit_api
+
             if prop.convert_value == builder.PropertyConvertValue.no_convert:
                 unconverted_values.add(py_name)
             elif not stype.is_value_converted():
@@ -902,6 +907,7 @@ def _emit_properties(
         unconverted_values=unconverted_values,
         to_string_values=to_string_values,
         parse_require=parse_require,
+        emit_api_overrides=emit_api_overrides,
     )
 
 
@@ -1001,6 +1007,7 @@ def _emit_type(ctx: Context, stype: builder.SpecType) -> None:
     unconverted_values = emitted_properties_metadata.unconverted_values
     to_string_values = emitted_properties_metadata.to_string_values
     parse_require = emitted_properties_metadata.parse_require
+    emit_api_overrides = emitted_properties_metadata.emit_api_overrides
 
     # Emit serial_class decorator
     ctx.out.write("@serial_class(\n")
@@ -1016,10 +1023,20 @@ def _emit_type(ctx: Context, stype: builder.SpecType) -> None:
         value_str = ", ".join([f'"{name}"' for name in sorted(values)])
         ctx.out.write(f"{INDENT}{key}={{{value_str}}},\n")
 
+    def write_string_map(key: str, mapping: dict[str, str]) -> None:
+        if len(mapping) == 0:
+            return
+        items = ", ".join(
+            f'"{py_name}": "{api_name}"'
+            for py_name, api_name in sorted(mapping.items())
+        )
+        ctx.out.write(f"{INDENT}{key}={{{items}}},\n")
+
     write_values("unconverted_keys", unconverted_keys)
     write_values("unconverted_values", unconverted_values)
     write_values("to_string_values", to_string_values)
     write_values("parse_require", parse_require)
+    write_string_map("emit_api_overrides", emit_api_overrides)
 
     ctx.out.write(")\n")
 

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/pkgs/type_spec/emit_typescript_util.py

@@ -51,6 +51,14 @@ def ts_name(name: str, name_case: builder.NameCase) -> str:
     return "".join([bits[0], *[x.title() for x in bits[1:]]])
 
 
+def ts_property_name(
+    prop: builder.SpecProperty, name_case: builder.NameCase | None = None
+) -> str:
+    if prop.emit_api is not None:
+        return prop.emit_api
+    return ts_name(prop.name, name_case if name_case is not None else prop.name_case)
+
+
 def emit_value_ts(
     ctx: EmitTypescriptContext,
     stype: builder.SpecType,
@@ -136,7 +144,7 @@ def emit_value_ts(
             else:
                 value_to_emit = value[prop_name]
             did_emit = True
-            typescript_name = ts_name(prop.name, prop.name_case)
+            typescript_name = ts_property_name(prop)
             obj_out += f"\n{INDENT * (indent + 1)}{typescript_name}: {emit_value_ts(ctx, prop.spec_type, value_to_emit, indent=indent + 1)},"
         whitespace = f"\n{INDENT * indent}" if did_emit else ""
         obj_out += f"{whitespace}}} as const"
@@ -218,7 +226,7 @@ def emit_type_ts(ctx: EmitTypescriptContext, stype: builder.SpecType) -> None:
         ctx.out.write("\n")
         for prop in stype.properties.values():
             ref_type = refer_to(ctx, prop.spec_type)
-            prop_name = ts_name(prop.name, prop.name_case)
+            prop_name = ts_property_name(prop)
             if prop.has_default and not prop.parse_require:
                 # For now, we'll assume the generated types with defaults are meant as
                 # arguments, thus treat like extant==missing

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/pkgs/type_spec/type_info/emit_type_info.py

@@ -16,7 +16,7 @@ from pkgs.serialization_util import serialize_for_api, serialize_for_storage
 
 from .. import builder, util
 from ..emit_python import python_field_name
-from ..emit_typescript_util import MODIFY_NOTICE, ts_name
+from ..emit_typescript_util import MODIFY_NOTICE, ts_property_name
 from ..value_spec import convert_to_value_spec_type
 
 ext_info_parser = CachedParser(type_info_t.ExtInfo, strict_property_parsing=True)
@@ -425,7 +425,7 @@ def _build_map_type(
                 map_property = MapProperty(
                     type_name=prop.name,
                     label=parts.label,
-                    api_name=ts_name(prop.name, prop.name_case),
+                    api_name=ts_property_name(prop),
                     extant=prop.extant,
                     type_path=type_path_of(prop.spec_type),
                     ext_info=parts.ext_info,

{uncountablepythonsdk-0.0.172 → uncountablepythonsdk-0.0.173}/uncountable/integration/telemetry.py

@@ -59,7 +59,7 @@ def one_line_formatter(record: ReadableLogRecord) -> str:
 @functools.cache
 def get_otel_resource() -> Resource:
     attributes: dict[str, base_t.JsonValue] = {
-        "service.name": "integration-server",
+        "service.name": os.environ.get("DD_SERVICE", "integration-server"),
         "sdk.version": get_version(),
     }
     unc_version = os.environ.get("UNC_VERSION")