haiway 0.18.0__tar.gz → 0.18.2__tar.gz

{haiway-0.18.0 → haiway-0.18.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haiway
-Version: 0.18.0
+Version: 0.18.2
 Summary: Framework for dependency injection and state management within structured concurrency model.
 Project-URL: Homepage, https://miquido.com
 Project-URL: Repository, https://github.com/miquido/haiway.git

{haiway-0.18.0 → haiway-0.18.2}/junit/test-results.xml

@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8"?><testsuites><testsuite name="pytest" errors="0" failures="0" skipped="0" tests="88" time="1.122" timestamp="2025-05-12T14:08:49.319975+00:00" hostname="pkrvmberfyhpb9w"><testcase classname="tests.test_async_queue" name="test_fails_when_stream_fails" time="0.001" /><testcase classname="tests.test_async_queue" name="test_cancels_when_iteration_cancels" time="0.001" /><testcase classname="tests.test_async_queue" name="test_ends_when_stream_ends" time="0.001" /><testcase classname="tests.test_async_queue" name="test_buffers_values_when_not_reading" time="0.001" /><testcase classname="tests.test_async_queue" name="test_delivers_buffer_when_streaming_fails" time="0.001" /><testcase classname="tests.test_async_queue" name="test_delivers_updates_when_sending" time="0.001" /><testcase classname="tests.test_async_queue" name="test_fails_when_sending_to_finished" time="0.001" /><testcase classname="tests.test_async_queue" name="test_ignores_when_finishing_when_finished" time="0.001" /><testcase classname="tests.test_async_stream" name="test_fails_when_stream_fails" time="0.001" /><testcase classname="tests.test_async_stream" name="test_cancels_when_iteration_cancels" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ends_when_stream_ends" time="0.001" /><testcase classname="tests.test_async_stream" name="test_finishes_without_buffer" time="0.001" /><testcase classname="tests.test_async_stream" name="test_fails_without_buffer" time="0.001" /><testcase classname="tests.test_async_stream" name="test_delivers_updates_when_sending" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ignores_when_sending_to_finished" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ignores_when_sending_to_failed" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ignores_when_finishing_when_finished" time="0.001" /><testcase classname="tests.test_async_stream" name="test_delivers_all_when_sending_async" time="0.001" /><testcase classname="tests.test_attribute_path" name="test_id_path_points_to_self" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_attribute_path_points_to_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_nested_attribute_path_points_to_nested_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_recursive_attribute_path_points_to_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_list_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_tuple_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_mixed_tuple_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_dict_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_id_path_set_updates_self" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_attribute_path_set_updates_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_nested_attribute_path_set_updates_nested_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_recursive_attribute_set_updates_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_list_item_path_set_updates_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_tuple_item_path_set_updates_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_mixed_tuple_item_set_updates_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_dict_item_path_set_updates_item" time="0.000" /><testcase classname="tests.test_auto_retry" name="test_returns_value_without_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_retries_with_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_logs_issue_with_errors" time="0.007" /><testcase classname="tests.test_auto_retry" name="test_fails_with_exceeding_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_fails_with_cancellation" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_retries_with_selected_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_fails_with_not_selected_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_returns_value_without_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_retries_with_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_with_exceeding_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_with_cancellation" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_when_cancelled" time="0.021" /><testcase classname="tests.test_auto_retry" name="test_async_uses_delay_with_errors" time="0.102" /><testcase classname="tests.test_auto_retry" name="test_async_uses_computed_delay_with_errors" time="0.107" /><testcase classname="tests.test_auto_retry" name="test_async_logs_issue_with_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_retries_with_selected_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_with_not_selected_errors" time="0.001" /><testcase classname="tests.test_cache" name="test_returns_cache_value_with_same_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_returns_fresh_value_with_different_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_returns_fresh_value_with_limit_exceed" time="0.001" /><testcase classname="tests.test_cache" name="test_returns_same_value_with_repeating_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_fails_with_error" time="0.001" /><testcase classname="tests.test_cache" name="test_returns_fresh_value_with_expiration_time_exceed" time="0.021" /><testcase classname="tests.test_cache" name="test_async_returns_cache_value_with_same_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_fresh_value_with_different_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_fresh_value_with_limit_exceed" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_same_value_with_repeating_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_fresh_value_with_expiration_time_exceed" time="0.021" /><testcase classname="tests.test_cache" name="test_async_cancel_waiting_does_not_cancel_task" time="0.502" /><testcase classname="tests.test_cache" name="test_async_expiration_does_not_cancel_task" time="0.021" /><testcase classname="tests.test_cache" name="test_async_fails_with_error" time="0.001" /><testcase classname="tests.test_context" name="test_state_is_available_according_to_context" time="0.001" /><testcase classname="tests.test_context" name="test_state_update_updates_local_context" time="0.001" /><testcase classname="tests.test_context" name="test_exceptions_are_propagated" time="0.001" /><testcase classname="tests.test_state" name="test_basic_initializes_with_arguments" time="0.002" /><testcase classname="tests.test_state" name="test_basic_initializes_with_defaults" time="0.001" /><testcase classname="tests.test_state" name="test_basic_equals_checks_properties" time="0.000" /><testcase classname="tests.test_state" name="test_basic_initializes_with_arguments_and_defaults" time="0.000" /><testcase classname="tests.test_state" name="test_parametrized_initializes_with_proper_parameters" time="0.000" /><testcase classname="tests.test_state" name="test_nested_initializes_with_proper_arguments" time="0.001" /><testcase classname="tests.test_state" name="test_dict_skips_missing_properties" time="0.000" /><testcase classname="tests.test_state" name="test_initialization_allows_missing_properties" time="0.000" /><testcase classname="tests.test_state" name="test_generic_subtypes_validation" time="0.002" /><testcase classname="tests.test_state" name="test_copying_leaves_same_object" time="0.000" /><testcase classname="tests.test_streaming" name="test_fails_when_generator_fails" time="0.001" /><testcase classname="tests.test_streaming" name="test_cancels_when_iteration_cancels" time="0.001" /><testcase classname="tests.test_streaming" name="test_ends_when_generator_ends" time="0.001" /><testcase classname="tests.test_streaming" name="test_delivers_updates_when_generating" time="0.001" /><testcase classname="tests.test_streaming" name="test_streaming_context_variables_access_is_preserved" time="0.001" /><testcase classname="tests.test_streaming" name="test_nested_streaming_streams_correctly" time="0.001" /><testcase classname="tests.test_timeout" name="test_returns_result_when_returning_value" time="0.001" /><testcase classname="tests.test_timeout" name="test_raises_with_error" time="0.001" /><testcase classname="tests.test_timeout" name="test_raises_with_cancel" time="0.011" /><testcase classname="tests.test_timeout" name="test_raises_with_timeout" time="0.011" /></testsuite></testsuites>
+<?xml version="1.0" encoding="utf-8"?><testsuites><testsuite name="pytest" errors="0" failures="0" skipped="0" tests="88" time="1.116" timestamp="2025-05-12T15:57:41.113378+00:00" hostname="pkrvmberfyhpb9w"><testcase classname="tests.test_async_queue" name="test_fails_when_stream_fails" time="0.001" /><testcase classname="tests.test_async_queue" name="test_cancels_when_iteration_cancels" time="0.001" /><testcase classname="tests.test_async_queue" name="test_ends_when_stream_ends" time="0.001" /><testcase classname="tests.test_async_queue" name="test_buffers_values_when_not_reading" time="0.001" /><testcase classname="tests.test_async_queue" name="test_delivers_buffer_when_streaming_fails" time="0.001" /><testcase classname="tests.test_async_queue" name="test_delivers_updates_when_sending" time="0.001" /><testcase classname="tests.test_async_queue" name="test_fails_when_sending_to_finished" time="0.001" /><testcase classname="tests.test_async_queue" name="test_ignores_when_finishing_when_finished" time="0.001" /><testcase classname="tests.test_async_stream" name="test_fails_when_stream_fails" time="0.001" /><testcase classname="tests.test_async_stream" name="test_cancels_when_iteration_cancels" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ends_when_stream_ends" time="0.001" /><testcase classname="tests.test_async_stream" name="test_finishes_without_buffer" time="0.001" /><testcase classname="tests.test_async_stream" name="test_fails_without_buffer" time="0.001" /><testcase classname="tests.test_async_stream" name="test_delivers_updates_when_sending" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ignores_when_sending_to_finished" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ignores_when_sending_to_failed" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ignores_when_finishing_when_finished" time="0.001" /><testcase classname="tests.test_async_stream" name="test_delivers_all_when_sending_async" time="0.001" /><testcase classname="tests.test_attribute_path" name="test_id_path_points_to_self" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_attribute_path_points_to_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_nested_attribute_path_points_to_nested_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_recursive_attribute_path_points_to_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_list_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_tuple_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_mixed_tuple_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_dict_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_id_path_set_updates_self" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_attribute_path_set_updates_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_nested_attribute_path_set_updates_nested_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_recursive_attribute_set_updates_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_list_item_path_set_updates_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_tuple_item_path_set_updates_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_mixed_tuple_item_set_updates_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_dict_item_path_set_updates_item" time="0.000" /><testcase classname="tests.test_auto_retry" name="test_returns_value_without_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_retries_with_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_logs_issue_with_errors" time="0.007" /><testcase classname="tests.test_auto_retry" name="test_fails_with_exceeding_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_fails_with_cancellation" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_retries_with_selected_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_fails_with_not_selected_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_returns_value_without_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_retries_with_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_with_exceeding_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_with_cancellation" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_when_cancelled" time="0.021" /><testcase classname="tests.test_auto_retry" name="test_async_uses_delay_with_errors" time="0.102" /><testcase classname="tests.test_auto_retry" name="test_async_uses_computed_delay_with_errors" time="0.107" /><testcase classname="tests.test_auto_retry" name="test_async_logs_issue_with_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_retries_with_selected_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_with_not_selected_errors" time="0.001" /><testcase classname="tests.test_cache" name="test_returns_cache_value_with_same_argument" time="0.000" /><testcase classname="tests.test_cache" name="test_returns_fresh_value_with_different_argument" time="0.000" /><testcase classname="tests.test_cache" name="test_returns_fresh_value_with_limit_exceed" time="0.000" /><testcase classname="tests.test_cache" name="test_returns_same_value_with_repeating_argument" time="0.000" /><testcase classname="tests.test_cache" name="test_fails_with_error" time="0.001" /><testcase classname="tests.test_cache" name="test_returns_fresh_value_with_expiration_time_exceed" time="0.021" /><testcase classname="tests.test_cache" name="test_async_returns_cache_value_with_same_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_fresh_value_with_different_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_fresh_value_with_limit_exceed" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_same_value_with_repeating_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_fresh_value_with_expiration_time_exceed" time="0.021" /><testcase classname="tests.test_cache" name="test_async_cancel_waiting_does_not_cancel_task" time="0.502" /><testcase classname="tests.test_cache" name="test_async_expiration_does_not_cancel_task" time="0.021" /><testcase classname="tests.test_cache" name="test_async_fails_with_error" time="0.001" /><testcase classname="tests.test_context" name="test_state_is_available_according_to_context" time="0.001" /><testcase classname="tests.test_context" name="test_state_update_updates_local_context" time="0.001" /><testcase classname="tests.test_context" name="test_exceptions_are_propagated" time="0.001" /><testcase classname="tests.test_state" name="test_basic_initializes_with_arguments" time="0.002" /><testcase classname="tests.test_state" name="test_basic_initializes_with_defaults" time="0.001" /><testcase classname="tests.test_state" name="test_basic_equals_checks_properties" time="0.000" /><testcase classname="tests.test_state" name="test_basic_initializes_with_arguments_and_defaults" time="0.000" /><testcase classname="tests.test_state" name="test_parametrized_initializes_with_proper_parameters" time="0.000" /><testcase classname="tests.test_state" name="test_nested_initializes_with_proper_arguments" time="0.001" /><testcase classname="tests.test_state" name="test_dict_skips_missing_properties" time="0.000" /><testcase classname="tests.test_state" name="test_initialization_allows_missing_properties" time="0.001" /><testcase classname="tests.test_state" name="test_generic_subtypes_validation" time="0.002" /><testcase classname="tests.test_state" name="test_copying_leaves_same_object" time="0.001" /><testcase classname="tests.test_streaming" name="test_fails_when_generator_fails" time="0.001" /><testcase classname="tests.test_streaming" name="test_cancels_when_iteration_cancels" time="0.001" /><testcase classname="tests.test_streaming" name="test_ends_when_generator_ends" time="0.001" /><testcase classname="tests.test_streaming" name="test_delivers_updates_when_generating" time="0.001" /><testcase classname="tests.test_streaming" name="test_streaming_context_variables_access_is_preserved" time="0.001" /><testcase classname="tests.test_streaming" name="test_nested_streaming_streams_correctly" time="0.001" /><testcase classname="tests.test_timeout" name="test_returns_result_when_returning_value" time="0.001" /><testcase classname="tests.test_timeout" name="test_raises_with_error" time="0.001" /><testcase classname="tests.test_timeout" name="test_raises_with_cancel" time="0.011" /><testcase classname="tests.test_timeout" name="test_raises_with_timeout" time="0.011" /></testsuite></testsuites>

{haiway-0.18.0 → haiway-0.18.2}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "haiway"
 description = "Framework for dependency injection and state management within structured concurrency model."
-version = "0.18.0"
+version = "0.18.2"
 readme = "README.md"
 maintainers = [
   { name = "Kacper Kaliński", email = "kacper.kalinski@miquido.com" },

{haiway-0.18.0 → haiway-0.18.2}/src/haiway/__init__.py

@@ -4,6 +4,8 @@ from haiway.context import (
     MissingContext,
     MissingState,
     Observability,
+    ObservabilityAttribute,
+    ObservabilityAttributesRecording,
     ObservabilityContext,
     ObservabilityEventRecording,
     ObservabilityLevel,
@@ -17,7 +19,7 @@ from haiway.context import (
     ctx,
 )
 from haiway.helpers import (
-    ArgumentsTrace,
+    LoggerObservability,
     ResultTrace,
     asynchronous,
     cache,
@@ -63,7 +65,6 @@ from haiway.utils import (
 
 __all__ = (
     "MISSING",
-    "ArgumentsTrace",
     "AsyncQueue",
     "AsyncStream",
     "AttributePath",
@@ -72,10 +73,13 @@ __all__ = (
     "DefaultValue",
     "Disposable",
     "Disposables",
+    "LoggerObservability",
     "Missing",
     "MissingContext",
     "MissingState",
     "Observability",
+    "ObservabilityAttribute",
+    "ObservabilityAttributesRecording",
     "ObservabilityContext",
     "ObservabilityEventRecording",
     "ObservabilityLevel",

{haiway-0.18.0 → haiway-0.18.2}/src/haiway/context/__init__.py

@@ -3,6 +3,8 @@ from haiway.context.disposables import Disposable, Disposables
 from haiway.context.identifier import ScopeIdentifier
 from haiway.context.observability import (
     Observability,
+    ObservabilityAttribute,
+    ObservabilityAttributesRecording,
     ObservabilityContext,
     ObservabilityEventRecording,
     ObservabilityLevel,
@@ -20,6 +22,8 @@ __all__ = (
     "MissingContext",
     "MissingState",
     "Observability",
+    "ObservabilityAttribute",
+    "ObservabilityAttributesRecording",
     "ObservabilityContext",
     "ObservabilityEventRecording",
     "ObservabilityLevel",

{haiway-0.18.0 → haiway-0.18.2}/src/haiway/context/access.py

@@ -18,7 +18,12 @@ from typing import Any, final, overload
 
 from haiway.context.disposables import Disposable, Disposables
 from haiway.context.identifier import ScopeIdentifier
-from haiway.context.observability import Observability, ObservabilityContext, ObservabilityLevel
+from haiway.context.observability import (
+    Observability,
+    ObservabilityAttribute,
+    ObservabilityContext,
+    ObservabilityLevel,
+)
 from haiway.context.state import ScopeState, StateContext
 from haiway.context.tasks import TaskGroupContext
 from haiway.state import State
@@ -462,6 +467,7 @@ class ctx:
         /,
         *args: Any,
         exception: BaseException | None = None,
+        **extra: Any,
     ) -> None:
         """
         Log using ERROR level within current scope context. When there is no current scope\
@@ -488,6 +494,7 @@ class ctx:
             message,
             *args,
             exception=exception,
+            **extra,
         )
 
     @staticmethod
@@ -496,6 +503,7 @@ class ctx:
         /,
         *args: Any,
         exception: Exception | None = None,
+        **extra: Any,
     ) -> None:
         """
         Log using WARNING level within current scope context. When there is no current scope\
@@ -522,6 +530,7 @@ class ctx:
             message,
             *args,
             exception=exception,
+            **extra,
         )
 
     @staticmethod
@@ -529,6 +538,7 @@ class ctx:
         message: str,
         /,
         *args: Any,
+        **extra: Any,
     ) -> None:
         """
         Log using INFO level within current scope context. When there is no current scope\
@@ -552,6 +562,7 @@ class ctx:
             message,
             *args,
             exception=None,
+            **extra,
         )
 
     @staticmethod
@@ -560,6 +571,7 @@ class ctx:
         /,
         *args: Any,
         exception: Exception | None = None,
+        **extra: Any,
     ) -> None:
         """
         Log using DEBUG level within current scope context. When there is no current scope\
@@ -582,10 +594,7 @@ class ctx:
         """
 
         ObservabilityContext.record_log(
-            ObservabilityLevel.DEBUG,
-            message,
-            *args,
-            exception=exception,
+            ObservabilityLevel.DEBUG, message, *args, exception=exception, **extra
         )
 
     @staticmethod
@@ -594,6 +603,7 @@ class ctx:
         /,
         *,
         level: ObservabilityLevel = ObservabilityLevel.INFO,
+        **extra: Any,
     ) -> None:
         """
         Record event within current scope context.
@@ -611,6 +621,7 @@ class ctx:
         ObservabilityContext.record_event(
             event,
             level=level,
+            **extra,
         )
 
     @staticmethod
@@ -620,6 +631,7 @@ class ctx:
         *,
         value: float | int,
         unit: str | None = None,
+        **extra: Any,
     ) -> None:
         """
         Record metric within current scope context.
@@ -642,4 +654,24 @@ class ctx:
             metric,
             value=value,
             unit=unit,
+            **extra,
+        )
+
+    @staticmethod
+    def attributes(**attributes: ObservabilityAttribute) -> None:
+        """
+        Record attributes within current scope context.
+
+        Parameters
+        ----------
+        **attributes: ObservabilityAttribute,
+            attributes to be recorded within current context.
+
+        Returns
+        -------
+        None
+        """
+
+        ObservabilityContext.record_attributes(
+            **attributes,
         )

{haiway-0.18.0 → haiway-0.18.2}/src/haiway/context/observability.py

@@ -1,3 +1,4 @@
+from collections.abc import Sequence
 from contextvars import ContextVar, Token
 from enum import IntEnum
 from logging import DEBUG as DEBUG_LOGGING
@@ -9,9 +10,8 @@ from types import TracebackType
 from typing import Any, Final, Protocol, Self, final, runtime_checkable
 
 from haiway.context.identifier import ScopeIdentifier
-
-# from haiway.context.logging import LoggerContext
 from haiway.state import State
+from haiway.types import MISSING, Missing
 
 __all__ = (
     "DEBUG",
@@ -19,6 +19,8 @@ __all__ = (
     "INFO",
     "WARNING",
     "Observability",
+    "ObservabilityAttribute",
+    "ObservabilityAttributesRecording",
     "ObservabilityContext",
     "ObservabilityEventRecording",
     "ObservabilityLevel",
@@ -42,6 +44,19 @@ WARNING: Final[int] = ObservabilityLevel.WARNING
 INFO: Final[int] = ObservabilityLevel.INFO
 DEBUG: Final[int] = ObservabilityLevel.DEBUG
 
+type ObservabilityAttribute = (
+    Sequence[str]
+    | Sequence[float]
+    | Sequence[int]
+    | Sequence[bool]
+    | str
+    | float
+    | int
+    | bool
+    | None
+    | Missing
+)
+
 
 @runtime_checkable
 class ObservabilityLogRecording(Protocol):
@@ -53,6 +68,7 @@ class ObservabilityLogRecording(Protocol):
         message: str,
         *args: Any,
         exception: BaseException | None,
+        **extra: Any,
     ) -> None: ...
 
 
@@ -65,6 +81,7 @@ class ObservabilityEventRecording(Protocol):
         *,
         level: ObservabilityLevel,
         event: State,
+        **extra: Any,
     ) -> None: ...
 
 
@@ -78,6 +95,17 @@ class ObservabilityMetricRecording(Protocol):
         metric: str,
         value: float | int,
         unit: str | None,
+        **extra: Any,
+    ) -> None: ...
+
+
+@runtime_checkable
+class ObservabilityAttributesRecording(Protocol):
+    def __call__(
+        self,
+        scope: ScopeIdentifier,
+        /,
+        **attributes: ObservabilityAttribute,
     ) -> None: ...
 
 
@@ -103,6 +131,7 @@ class ObservabilityScopeExiting(Protocol):
 
 class Observability:  # avoiding State inheritance to prevent propagation as scope state
     __slots__ = (
+        "attributes_recording",
         "event_recording",
         "log_recording",
         "metric_recording",
@@ -115,6 +144,7 @@ class Observability:  # avoiding State inheritance to prevent propagation as sco
         log_recording: ObservabilityLogRecording,
         metric_recording: ObservabilityMetricRecording,
         event_recording: ObservabilityEventRecording,
+        attributes_recording: ObservabilityAttributesRecording,
         scope_entering: ObservabilityScopeEntering,
         scope_exiting: ObservabilityScopeExiting,
     ) -> None:
@@ -136,6 +166,13 @@ class Observability:  # avoiding State inheritance to prevent propagation as sco
             "event_recording",
             event_recording,
         )
+        self.attributes_recording: ObservabilityAttributesRecording
+        object.__setattr__(
+            self,
+            "attributes_recording",
+            attributes_recording,
+        )
+
         self.scope_entering: ObservabilityScopeEntering
         object.__setattr__(
             self,
@@ -180,6 +217,7 @@ def _logger_observability(
         message: str,
         *args: Any,
         exception: BaseException | None,
+        **extra: Any,
     ) -> None:
         logger.log(
             level,
@@ -194,6 +232,7 @@ def _logger_observability(
         *,
         level: ObservabilityLevel,
         event: State,
+        **extra: Any,
     ) -> None:
         logger.log(
             level,
@@ -207,10 +246,25 @@ def _logger_observability(
         metric: str,
         value: float | int,
         unit: str | None,
+        **extra: Any,
     ) -> None:
         logger.log(
             INFO,
-            f"{scope.unique_name} Recorded metric - {metric}:{value}{unit or ''}",
+            f"{scope.unique_name} Recorded metric: {metric}={value}{unit or ''}",
+        )
+
+    def attributes_recording(
+        scope: ScopeIdentifier,
+        /,
+        **attributes: ObservabilityAttribute,
+    ) -> None:
+        if not attributes:
+            return
+
+        logger.log(
+            INFO,
+            f"{scope.unique_name} Recorded attributes:"
+            f"\n{'\n'.join(f'{k}: {v}' for k, v in attributes.items() if v is not None and v is not MISSING)}",  # noqa: E501
         )
 
     def scope_entering[Metric: State](
@@ -238,6 +292,7 @@ def _logger_observability(
         log_recording=log_recording,
         event_recording=event_recording,
         metric_recording=metric_recording,
+        attributes_recording=attributes_recording,
         scope_entering=scope_entering,
         scope_exiting=scope_exiting,
     )
@@ -302,6 +357,7 @@ class ObservabilityContext:
         /,
         *args: Any,
         exception: BaseException | None,
+        **extra: Any,
     ) -> None:
         try:  # catch exceptions - we don't wan't to blow up on observability
             context: Self = cls._context.get()
@@ -313,6 +369,7 @@ class ObservabilityContext:
                     message,
                     *args,
                     exception=exception,
+                    **extra,
                 )
 
         except LookupError:
@@ -330,6 +387,7 @@ class ObservabilityContext:
         /,
         *,
         level: ObservabilityLevel,
+        **extra: Any,
     ) -> None:
         try:  # catch exceptions - we don't wan't to blow up on observability
             context: Self = cls._context.get()
@@ -339,6 +397,7 @@ class ObservabilityContext:
                     context._scope,
                     level=level,
                     event=event,
+                    **extra,
                 )
 
         except Exception as exc:
@@ -356,6 +415,7 @@ class ObservabilityContext:
         *,
         value: float | int,
         unit: str | None,
+        **extra: Any,
     ) -> None:
         try:  # catch exceptions - we don't wan't to blow up on observability
             context: Self = cls._context.get()
@@ -366,6 +426,7 @@ class ObservabilityContext:
                     metric=metric,
                     value=value,
                     unit=unit,
+                    **extra,
                 )
 
         except Exception as exc:
@@ -375,6 +436,27 @@ class ObservabilityContext:
                 exception=exc,
             )
 
+    @classmethod
+    def record_attributes(
+        cls,
+        **attributes: ObservabilityAttribute,
+    ) -> None:
+        try:  # catch exceptions - we don't wan't to blow up on observability
+            context: Self = cls._context.get()
+
+            if context.observability is not None:
+                context.observability.attributes_recording(
+                    context._scope,
+                    **attributes,
+                )
+
+        except Exception as exc:
+            cls.record_log(
+                ERROR,
+                f"Failed to record attributes: {attributes}",
+                exception=exc,
+            )
+
     __slots__ = (
         "_scope",
         "_token",

{haiway-0.18.0 → haiway-0.18.2}/src/haiway/helpers/__init__.py

@@ -1,19 +1,16 @@
 from haiway.helpers.asynchrony import asynchronous, wrap_async
 from haiway.helpers.caching import CacheMakeKey, CacheRead, CacheWrite, cache
+from haiway.helpers.observability import LoggerObservability
 from haiway.helpers.retries import retry
 from haiway.helpers.throttling import throttle
 from haiway.helpers.timeouted import timeout
-from haiway.helpers.tracing import (
-    ArgumentsTrace,
-    ResultTrace,
-    traced,
-)
+from haiway.helpers.tracing import ResultTrace, traced
 
 __all__ = (
-    "ArgumentsTrace",
     "CacheMakeKey",
     "CacheRead",
     "CacheWrite",
+    "LoggerObservability",
     "ResultTrace",
     "asynchronous",
     "cache",

{haiway-0.18.0 → haiway-0.18.2}/src/haiway/helpers/observability.py

@@ -3,7 +3,9 @@ from time import monotonic
 from typing import Any
 
 from haiway.context import Observability, ObservabilityLevel, ScopeIdentifier
+from haiway.context.observability import ObservabilityAttribute
 from haiway.state import State
+from haiway.types import MISSING
 
 __all__ = ("LoggerObservability",)
 
@@ -60,7 +62,7 @@ class ScopeStore:
         return True  # successfully completed
 
 
-def LoggerObservability(  # noqa: C901
+def LoggerObservability(  # noqa: C901, PLR0915
     logger: Logger,
     /,
     *,
@@ -76,6 +78,7 @@ def LoggerObservability(  # noqa: C901
         message: str,
         *args: Any,
         exception: BaseException | None,
+        **extra: Any,
     ) -> None:
         assert root_scope is not None  # nosec: B101
         assert scope.scope_id in scopes  # nosec: B101
@@ -93,6 +96,7 @@ def LoggerObservability(  # noqa: C901
         *,
         level: ObservabilityLevel,
         event: State,
+        **extra: Any,
     ) -> None:
         assert root_scope is not None  # nosec: B101
         assert scope.scope_id in scopes  # nosec: B101
@@ -113,11 +117,12 @@ def LoggerObservability(  # noqa: C901
         metric: str,
         value: float | int,
         unit: str | None,
+        **extra: Any,
     ) -> None:
         assert root_scope is not None  # nosec: B101
         assert scope.scope_id in scopes  # nosec: B101
 
-        metric_str: str = f"Metric - {metric}:{value}{unit or ''}"
+        metric_str: str = f"Metric: {metric}={value}{unit or ''}"
         if summarize_context:  # store only for summary
             scopes[scope.scope_id].store.append(metric_str)
 
@@ -126,6 +131,26 @@ def LoggerObservability(  # noqa: C901
             f"{scope.unique_name} {metric_str}",
         )
 
+    def attributes_recording(
+        scope: ScopeIdentifier,
+        /,
+        **attributes: ObservabilityAttribute,
+    ) -> None:
+        if not attributes:
+            return
+
+        attributes_str: str = (
+            f"{scope.unique_name} Attributes:"
+            f"\n{'\n'.join(f'{k}: {v}' for k, v in attributes.items() if v is not None and v is not MISSING)}"  # noqa: E501
+        )
+        if summarize_context:  # store only for summary
+            scopes[scope.scope_id].store.append(attributes_str)
+
+        logger.log(
+            ObservabilityLevel.INFO,
+            attributes_str,
+        )
+
     def scope_entering[Metric: State](
         scope: ScopeIdentifier,
         /,
@@ -196,6 +221,7 @@ def LoggerObservability(  # noqa: C901
         log_recording=log_recording,
         event_recording=event_recording,
         metric_recording=metric_recording,
+        attributes_recording=attributes_recording,
         scope_entering=scope_entering,
         scope_exiting=scope_exiting,
     )

{haiway-0.18.0 → haiway-0.18.2}/src/haiway/helpers/tracing.py

@@ -1,5 +1,5 @@
 from asyncio import iscoroutinefunction
-from collections.abc import Callable, Coroutine, Sequence
+from collections.abc import Callable, Coroutine
 from typing import Any, Self, cast, overload
 
 from haiway.context import ctx
@@ -8,43 +8,11 @@ from haiway.types import MISSING, Missing
 from haiway.utils import mimic_function
 
 __all__ = (
-    "ArgumentsTrace",
     "ResultTrace",
     "traced",
 )
 
 
-class ArgumentsTrace(State):
-    if __debug__:
-
-        @classmethod
-        def of(
-            cls,
-            *args: Any,
-            **kwargs: Any,
-        ) -> Self:
-            return cls(
-                args=[f"{arg}" for arg in args] if args else MISSING,
-                kwargs=[f"{key}:{arg}" for key, arg in kwargs.items()] if kwargs else MISSING,
-            )
-
-    else:  # remove tracing for non debug runs to prevent accidental secret leaks
-
-        @classmethod
-        def of(
-            cls,
-            *args: Any,
-            **kwargs: Any,
-        ) -> Self:
-            return cls(
-                args=MISSING,
-                kwargs=MISSING,
-            )
-
-    args: Sequence[str] | Missing
-    kwargs: Sequence[str] | Missing
-
-
 class ResultTrace(State):
     if __debug__:
 
@@ -128,7 +96,11 @@ def _traced_sync[**Args, Result](
         **kwargs: Args.kwargs,
     ) -> Result:
         with ctx.scope(label):
-            ctx.event(ArgumentsTrace.of(*args, **kwargs))
+            ctx.attributes(
+                **{f"[{idx}]": f"{arg}" for idx, arg in enumerate(args) if arg is not MISSING}
+            )
+            ctx.attributes(**{key: f"{arg}" for key, arg in kwargs.items() if arg is not MISSING})
+
             try:
                 result: Result = function(*args, **kwargs)
                 ctx.event(ResultTrace.of(result))
@@ -154,7 +126,12 @@ def _traced_async[**Args, Result](
         **kwargs: Args.kwargs,
     ) -> Result:
         with ctx.scope(label):
-            ctx.event(ArgumentsTrace.of(*args, **kwargs))
+            for idx, arg in enumerate(args):
+                ctx.attributes(**{f"[{idx}]": f"{arg}"})
+
+            for key, arg in kwargs.items():
+                ctx.attributes(**{key: f"{arg}"})
+
             try:
                 result: Result = await function(*args, **kwargs)
                 ctx.event(ResultTrace.of(result))