julee.util.repos.temporal.data_converter
========================================

.. py:module:: julee.util.repos.temporal.data_converter

.. autoapi-nested-parse::

   Custom Temporal data converter with support for temporal_validation context.

   This module provides a custom Pydantic data converter that automatically
   adds temporal_validation=True context when deserializing Pydantic models.
   This allows domain models to implement context-aware validation that can
   be more permissive during Temporal serialization/deserialization.



Attributes
----------

.. autoapisummary::

   julee.util.repos.temporal.data_converter.temporal_data_converter


Classes
-------

.. autoapisummary::

   julee.util.repos.temporal.data_converter.TemporalValidationPayloadConverter
   julee.util.repos.temporal.data_converter.TemporalValidationPydanticConverter


Functions
---------

.. autoapisummary::

   julee.util.repos.temporal.data_converter.create_temporal_data_converter


Module Contents
---------------

.. py:class:: TemporalValidationPayloadConverter(to_json_options = None)

   Bases: :py:obj:`temporalio.converter.CompositePayloadConverter`


   Custom payload converter that uses temporal validation context.

   This payload converter extends CompositePayloadConverter to use our
   custom TemporalValidationPydanticConverter for JSON serialization,
   ensuring all Pydantic models get temporal_validation context.


.. py:class:: TemporalValidationPydanticConverter(to_json_options = None)

   Bases: :py:obj:`temporalio.contrib.pydantic.PydanticJSONPlainPayloadConverter`


   Custom Pydantic JSON converter that adds temporal_validation context.

   This converter extends the standard PydanticJSONPlainPayloadConverter
   to automatically add temporal_validation=True context when deserializing
   Pydantic models. This allows domain models to implement more permissive
   validation during Temporal operations while maintaining strict validation
   for direct instantiation.


   .. py:method:: from_payload(payload, type_hint = None)

      Deserialize payload with temporal_validation context.

      This method overrides the base implementation to always add
      temporal_validation=True to the validation context. This allows
      Pydantic models to detect when they're being deserialized by
      Temporal and apply appropriate validation rules.

      :param payload: The Temporal payload to deserialize
      :param type_hint: Optional type hint for the expected return type

      :returns: Deserialized object with temporal validation context applied



.. py:function:: create_temporal_data_converter(to_json_options = None)

   Create a data converter with temporal validation support.

   This factory function creates a DataConverter that uses our custom
   TemporalValidationPayloadConverter for serialization. This
   ensures that all Pydantic models are deserialized with the
   temporal_validation context.

   :param to_json_options: Optional configuration for JSON serialization

   :returns: DataConverter configured with temporal validation support


.. py:data:: temporal_data_converter

   Default Temporal data converter with temporal_validation context support.

   This data converter automatically adds temporal_validation=True context
   when deserializing Pydantic models, allowing domain models to implement
   context-aware validation rules.

   Usage:
       client = Client(
           data_converter=temporal_data_converter,
           ...
       )