uipath-core 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

uipath/core/serialization/__init__.py

@@ -0,0 +1,5 @@
+"""Serialization utilities for converting Python objects to various formats."""
+
+from .json import serialize_defaults, serialize_json
+
+__all__ = ["serialize_defaults", "serialize_json"]

uipath/core/serialization/json.py

@@ -0,0 +1,150 @@
+"""JSON serialization utilities for converting Python objects to JSON formats."""
+
+import json
+from dataclasses import asdict, is_dataclass
+from datetime import datetime, timezone
+from enum import Enum
+from typing import Any, cast
+from zoneinfo import ZoneInfo
+
+from pydantic import BaseModel
+
+
+def serialize_defaults(
+    obj: Any,
+) -> dict[str, Any] | list[Any] | str | int | float | bool | None:
+    """Convert Python objects to JSON-serializable formats.
+
+    Handles common Python types that are not natively JSON-serializable:
+    - Pydantic models (v1 and v2)
+    - Dataclasses
+    - Enums
+    - Datetime objects
+    - Timezone objects
+    - Named tuples
+    - Sets and tuples
+
+    This function is designed to be used as the `default` parameter in json.dumps():
+    ```python
+    import json
+    result = json.dumps(obj, default=serialize_defaults)
+    ```
+
+    Or use the convenience function `serialize_json()` which wraps this:
+    ```python
+    result = serialize_json(obj)
+    ```
+
+    Args:
+        obj: The object to serialize
+
+    Returns:
+        A JSON-serializable representation of the object:
+        - Pydantic models: dict from model_dump()
+        - Dataclasses: dict from asdict()
+        - Enums: the enum value (recursively serialized)
+        - datetime: ISO format string
+        - timezone/ZoneInfo: timezone name
+        - sets/tuples: converted to lists
+        - named tuples: converted to dict
+        - Primitives (None, bool, int, float, str, list, dict): returned unchanged
+        - Other types: converted to string with str()
+
+    Examples:
+        >>> from datetime import datetime
+        >>> from pydantic import BaseModel
+        >>>
+        >>> class User(BaseModel):
+        ...     name: str
+        ...     created_at: datetime
+        >>>
+        >>> user = User(name="Alice", created_at=datetime.now())
+        >>> import json
+        >>> json.dumps(user, default=serialize_defaults)
+        '{"name": "Alice", "created_at": "2024-01-01T12:00:00"}'
+        >>> # Or use the convenience function
+        >>> serialize_json(user)
+        '{"name": "Alice", "created_at": "2024-01-01T12:00:00"}'
+    """
+    # Handle Pydantic BaseModel instances
+    if hasattr(obj, "model_dump") and not isinstance(obj, type):
+        return obj.model_dump(exclude_none=True, mode="json")
+
+    # Handle Pydantic model classes - convert to schema representation
+    if isinstance(obj, type) and issubclass(obj, BaseModel):
+        return {
+            "__class__": obj.__name__,
+            "__module__": obj.__module__,
+            "schema": obj.model_json_schema(),
+        }
+
+    # Handle Pydantic v1 models
+    if hasattr(obj, "dict") and not isinstance(obj, type):
+        return obj.dict()
+
+    # Handle objects with to_dict method
+    if hasattr(obj, "to_dict") and not isinstance(obj, type):
+        return obj.to_dict()
+
+    # Handle dataclasses
+    if is_dataclass(obj) and not isinstance(obj, type):
+        return asdict(obj)
+
+    # Handle enums - recursively serialize the value
+    if isinstance(obj, Enum):
+        return serialize_defaults(obj.value)
+
+    # Handle sets and tuples
+    if isinstance(obj, (set, tuple)):
+        # Check if it's a named tuple (has _asdict method)
+        if hasattr(obj, "_asdict") and callable(
+            obj._asdict  # pyright: ignore[reportAttributeAccessIssue]
+        ):
+            return cast(
+                dict[str, Any],
+                obj._asdict(),  # pyright: ignore[reportAttributeAccessIssue]
+            )
+        # Convert to list
+        return list(obj)
+
+    # Handle datetime objects
+    if isinstance(obj, datetime):
+        return obj.isoformat()
+
+    # Handle timezone objects
+    if isinstance(obj, (timezone, ZoneInfo)):
+        return obj.tzname(None)
+
+    # Allow JSON-serializable primitives to pass through unchanged
+    if obj is None or isinstance(obj, (bool, int, float, str, list, dict)):
+        return obj
+
+    # Fallback: convert to string
+    return str(obj)
+
+
+def serialize_json(obj: Any) -> str:
+    """Serialize Python object to JSON string.
+
+    This is a convenience function that wraps json.dumps() with serialize_defaults()
+    as the default handler for non-JSON-serializable types.
+
+    Args:
+        obj: The object to serialize to JSON
+
+    Returns:
+        JSON string representation of the object
+
+    Examples:
+        >>> from datetime import datetime
+        >>> from pydantic import BaseModel
+        >>>
+        >>> class Task(BaseModel):
+        ...     name: str
+        ...     created: datetime
+        >>>
+        >>> task = Task(name="Review PR", created=datetime(2024, 1, 15, 10, 30))
+        >>> serialize_json(task)
+        '{"name": "Review PR", "created": "2024-01-15T10:30:00"}'
+    """
+    return json.dumps(obj, default=serialize_defaults)

uipath/core/tracing/_utils.py

@@ -3,14 +3,11 @@
 import inspect
 import json
 from collections.abc import Callable
-from dataclasses import asdict, is_dataclass
-from datetime import datetime, timezone
-from enum import Enum
-from typing import Any, Mapping, Optional, cast
-from zoneinfo import ZoneInfo
+from typing import Any, Mapping, Optional
 
 from opentelemetry.trace import Span
-from pydantic import BaseModel
+
+from uipath.core.serialization import serialize_json
 
 
 def get_supported_params(
@@ -31,64 +28,19 @@ def get_supported_params(
     return supported
 
 
-def _simple_serialize_defaults(
-    obj: Any,
-) -> dict[str, Any] | list[Any] | str | int | float | bool | None:
-    # Handle Pydantic BaseModel instances
-    if hasattr(obj, "model_dump") and not isinstance(obj, type):
-        return obj.model_dump(exclude_none=True, mode="json")
-
-    # Handle classes - convert to schema representation
-    if isinstance(obj, type) and issubclass(obj, BaseModel):
-        return {
-            "__class__": obj.__name__,
-            "__module__": obj.__module__,
-            "schema": obj.model_json_schema(),
-        }
-    if hasattr(obj, "dict") and not isinstance(obj, type):
-        return obj.dict()
-    if hasattr(obj, "to_dict") and not isinstance(obj, type):
-        return obj.to_dict()
-
-    # Handle dataclasses
-    if is_dataclass(obj) and not isinstance(obj, type):
-        return asdict(obj)
-
-    # Handle enums
-    if isinstance(obj, Enum):
-        return _simple_serialize_defaults(obj.value)
-
-    if isinstance(obj, (set, tuple)):
-        if hasattr(obj, "_asdict") and callable(obj._asdict):  # pyright: ignore[reportAttributeAccessIssue]
-            return cast(dict[str, Any], obj._asdict())  # pyright: ignore[reportAttributeAccessIssue]
-        return list(obj)
-
-    if isinstance(obj, datetime):
-        return obj.isoformat()
-
-    if isinstance(obj, (timezone, ZoneInfo)):
-        return obj.tzname(None)
-
-    # Allow JSON-serializable primitives to pass through unchanged
-    if obj is None or isinstance(obj, (bool, int, float, str)):
-        return obj
-
-    return str(obj)
-
-
 def format_args_for_trace_json(
     signature: inspect.Signature, *args: Any, **kwargs: Any
 ) -> str:
     """Return a JSON string of inputs from the function signature."""
     result = format_args_for_trace(signature, *args, **kwargs)
-    return json.dumps(result, default=_simple_serialize_defaults)
+    return serialize_json(result)
 
 
 def format_object_for_trace_json(
     input_object: Any,
 ) -> str:
     """Return a JSON string of inputs from the function signature."""
-    return json.dumps(input_object, default=_simple_serialize_defaults)
+    return serialize_json(input_object)
 
 
 def format_args_for_trace(

{uipath_core-0.2.1.dist-info → uipath_core-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath-core
-Version: 0.2.1
+Version: 0.2.2
 Summary: UiPath Core abstractions
 Project-URL: Homepage, https://uipath.com
 Project-URL: Repository, https://github.com/UiPath/uipath-core-python

{uipath_core-0.2.1.dist-info → uipath_core-0.2.2.dist-info}/RECORD

@@ -18,15 +18,17 @@ uipath/core/guardrails/__init__.py,sha256=hUCmD4y5te2iy01YnJlBuf2RWvqxmsNzoyOamX
 uipath/core/guardrails/_deterministic_guardrails_service.py,sha256=61ROXYmX3rjBfFUp7E83fm4Lk7h1DlJeukpZm7uzVqQ,6355
 uipath/core/guardrails/_evaluators.py,sha256=10tIRUufxoy9MkZPb-ytjsCSCIfIqQSOYXyEl4G7PSw,15649
 uipath/core/guardrails/guardrails.py,sha256=sTxsNHilEX908aF-WtQWVOQ4dCCwMgAepDebH35ngvo,5430
+uipath/core/serialization/__init__.py,sha256=thAMx0WY03vnqhKCDVc9burqKWDxSNn3R-CJQU_1LIs,186
+uipath/core/serialization/json.py,sha256=S0-ykGfroleRC0gJBNuTyJCx-GB8e6ZG9uTUKiD4PSc,4791
 uipath/core/tracing/__init__.py,sha256=Y0wfRSGCVcDoFYTmTkVQElu5JE91h4dTNkKQnd86dBM,568
-uipath/core/tracing/_utils.py,sha256=FiCFGOFa4czruhlSF87Q5Q4jX9KKPHZiw8k14K7W5v4,6636
+uipath/core/tracing/_utils.py,sha256=VnDd-oMwZXPKa7bdda2bFLSZXXXhJ8d4RQ4g7Mx1otU,4915
 uipath/core/tracing/decorators.py,sha256=JDNULkUu-Ufg8pJslG4i6Q2pmqaGNDS8NFRPgFs29Dw,11937
 uipath/core/tracing/exporters.py,sha256=FClouEEQfk3F8J7G_NFoarDJM3R0-gA5jUxA5xRHx5s,1562
 uipath/core/tracing/processors.py,sha256=XlMKA_AWwrtC-0ytnAHxl4P9kXlQdsjcn8zwnSpZKts,2500
 uipath/core/tracing/span_utils.py,sha256=LZXNdnI0-fhKe49CLPsvMJIfh9zdzk8rK4g4YN5RfDU,13064
 uipath/core/tracing/trace_manager.py,sha256=vmPup-C2pSgwpSdcCzAjzP_nTtRWZgqlxnNT50ygOfk,3843
 uipath/core/tracing/types.py,sha256=8A8fFuWqMGk0SzIrFbMajmY6LA3w57h-YA602OctCrI,634
-uipath_core-0.2.1.dist-info/METADATA,sha256=zPRzoolLStzjDDepr4C2iN46ZGrinRfrR-UyxjC1yak,938
-uipath_core-0.2.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-uipath_core-0.2.1.dist-info/licenses/LICENSE,sha256=-KBavWXepyDjimmzH5fVAsi-6jNVpIKFc2kZs0Ri4ng,1058
-uipath_core-0.2.1.dist-info/RECORD,,
+uipath_core-0.2.2.dist-info/METADATA,sha256=pjzOsvo24CI1AOHmZ2pHLp0kXx9YtZk0fLkBHntjrTw,938
+uipath_core-0.2.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+uipath_core-0.2.2.dist-info/licenses/LICENSE,sha256=-KBavWXepyDjimmzH5fVAsi-6jNVpIKFc2kZs0Ri4ng,1058
+uipath_core-0.2.2.dist-info/RECORD,,