haiway 0.21.1__tar.gz → 0.21.2__tar.gz

haiway-0.21.2/CLAUDE.md

@@ -0,0 +1,163 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Commands
+
+```bash
+# Setup development environment
+make venv
+. ./.venv/bin/activate
+
+# Sync dependencies
+make sync
+
+# Update dependencies
+make update
+
+# Run formatter - make sure to run with activated venv
+make format
+
+# Run linters and type checker - make sure to run with activated venv
+make lint
+
+# Run test suite - make sure to run with activated venv
+make test
+
+# Run a single test - make sure to run with activated venv
+python -B -m pytest -v tests/test_file.py::test_function
+```
+
+## Architecture Overview
+
+Haiway is a Python framework (3.12+) designed for functional programming with structured concurrency. It focuses on:
+
+1. **Immutable State Management**: Using State classes for type-safe, immutable data structures
+2. **Context-based Dependency Injection**: Propagating state through execution contexts
+3. **Functional Approach**: Emphasizing pure functions over objects with methods
+
+### Core Components
+
+- **Context System** (`haiway.context`): Provides scoped execution environments with access to state
+- **State Management** (`haiway.state`): Immutable data structures with validation
+- **Helpers** (`haiway.helpers`): Utilities for async operations, caching, retries, etc.
+- **Types** (`haiway.types`): Base type definitions
+
+## Development Patterns
+
+### Defining Types
+
+```python
+from typing import Protocol, runtime_checkable
+from haiway import State
+
+# Data structure
+class UserData(State):
+    id: str
+    name: str
+    email: str | None = None
+
+# Function interface
+@runtime_checkable
+class UserFetching(Protocol):
+    async def __call__(self, id: str) -> UserData: ...
+```
+
+### Managing State
+
+```python
+from haiway import State, ctx
+from .types import UserFetching, UserData
+
+# Configuration state
+class UserServiceConfig(State):
+    api_url: str = "https://api.example.com"
+    timeout_seconds: int = 30
+
+# Functionality container
+class UserService(State):
+    # Function implementations
+    fetching: UserFetching
+
+    # Class method interface
+    @classmethod
+    async def fetch_user(cls, id: str) -> UserData:
+        return await ctx.state(cls).fetching(id)
+```
+
+### Implementation
+
+```python
+from haiway import ctx
+from .types import UserData
+from .state import UserService, UserServiceConfig
+
+# Concrete implementation
+async def http_user_fetching(id: str) -> UserData:
+    config = ctx.state(UserServiceConfig)
+    # Implementation using config.api_url
+    return UserData(id=id, name="Example User")
+
+# Factory function
+def http_user_service() -> UserService:
+    return UserService(fetching=http_user_fetching)
+```
+
+### Context Usage
+
+```python
+from haiway import ctx
+from .implementation import http_user_service
+from .state import UserServiceConfig
+
+async def main():
+    # Set up execution context
+    async with ctx.scope(
+        "main",
+        http_user_service(),
+        UserServiceConfig(api_url="https://custom-api.example.com")
+    ):
+        # Use functionality through class methods
+        user = await UserService.fetch_user("user-123")
+```
+
+## Common Patterns
+
+1. **Immutable Updates**:
+   ```python
+   # Create new instance with updated values
+   updated_config = config.updated(api_url="https://new-api.example.com")
+   ```
+
+2. **Context Access**:
+   ```python
+   # Get state from current context
+   config = ctx.state(ConfigType)
+   ```
+
+3. **Disposable Resources**:
+   ```python
+   # Resources that need cleanup
+   async def create_resource() -> tuple[Resource, Disposable]:
+      resource = Resource()
+      async def cleanup(): await resource.close()
+      return resource, ctx.disposable(cleanup)
+   ```
+
+## Testing Guidelines
+
+- Tests use pytest with pytest-asyncio
+- Mock context values with `ctx.updated`
+- For async tests, use the `@pytest.mark.asyncio` decorator
+- Immutable state makes testing simpler - no need to reset between tests
+
+```python
+import pytest
+from haiway import ctx
+
+@pytest.mark.asyncio
+async def test_functionality():
+    async with ctx.scope("test", TestState(value="test")):
+        result = await some_function()
+        assert result == expected_result
+```

{haiway-0.21.1 → haiway-0.21.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haiway
-Version: 0.21.1
+Version: 0.21.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.21.1 → haiway-0.21.2}/guidelines/llms.txt

@@ -31,13 +31,17 @@ Define interfaces using Protocol and data using State:
 
 ```python
 from typing import Protocol, Any, runtime_checkable
+from collections.abc import Sequence, Mapping, Set
 from haiway import State
 
-# Data structure
+# Data structure - use abstract collection types
 class UserData(State):
     id: str
     name: str
     email: str | None = None
+    tags: Sequence[str] = ()           # Not list[str] - becomes tuple
+    metadata: Mapping[str, str] = {}   # Not dict[str, str] - stays dict
+    roles: Set[str] = frozenset()      # Not set[str] - becomes frozenset
 
 # Function interface
 @runtime_checkable
@@ -132,6 +136,7 @@ async with ctx.scope("dev-context", dev_config):
 
 ```python
 from typing import Protocol, Any, runtime_checkable
+from collections.abc import Sequence
 from uuid import UUID, uuid4
 from datetime import datetime
 from haiway import State, ctx
@@ -142,6 +147,7 @@ class Note(State):
     content: str
     created_at: datetime
     updated_at: datetime
+    tags: Sequence[str] = ()  # Use Sequence, not list
 
 @runtime_checkable
 class NoteCreating(Protocol):
@@ -232,6 +238,8 @@ async def run_notes_app():
    - Keep states immutable
    - Use .updated() for state variants
    - Define defaults for optional values
+   - Use abstract collection types: Sequence[T] not list[T], Mapping[K,V] not dict[K,V], Set[T] not set[T]
+   - Lists become tuples, sets become frozensets for immutability
 
 3. **Function Implementations**
    - Access context through ctx.state()
@@ -257,3 +265,24 @@ async def run_notes_app():
    - Define custom error types in types.py
    - Handle errors explicitly at appropriate levels
    - Maintain immutability in error cases
+
+## State Type Validation
+
+State classes validate all supported Python types:
+
+- **Basic Types**: int, str, bool, float, bytes, None
+- **Collection Types**: 
+  - Sequence[T] (converts lists to tuples)
+  - Mapping[K,V] (keeps as dict)
+  - Set[T] (converts to frozenset)
+  - tuple[T, ...] (fixed/variable length)
+- **Special Types**: UUID, datetime, date, time, timedelta, timezone, Path, re.Pattern
+- **Union Types**: str | None, int | float
+- **Literal Types**: Literal["a", "b", "c"] 
+- **Enum Types**: Standard Enum and StrEnum classes
+- **Callable Types**: Function types and Protocol interfaces
+- **TypedDict**: Structure validation with Required/NotRequired
+- **Nested State**: Recursive validation including generics
+- **Any Type**: Accepts any value without validation
+
+**Critical Rule**: Always use abstract collection types (Sequence, Mapping, Set) instead of concrete types (list, dict, set) to ensure immutability and proper validation.

haiway-0.21.2/guidelines/state.md

@@ -0,0 +1,282 @@
+## State Management
+
+Haiway's state management system is built around the `State` class, which provides immutable, type-safe data structures with validation. Unlike traditional mutable objects, State instances cannot be modified after creation, ensuring predictable behavior, especially in concurrent environments. This guide explains how to effectively use the State class to manage your application's data.
+
+### Defining State Classes
+
+State classes are defined by subclassing the `State` base class and declaring typed attributes:
+
+```python
+from haiway import State
+from uuid import UUID
+from datetime import datetime
+
+class User(State):
+    id: UUID
+    name: str
+    email: str | None = None
+    created_at: datetime
+```
+
+Key features of State class definitions:
+
+- **Type Annotations**: All attributes must have type annotations
+- **Optional Attributes**: Provide default values for optional attributes
+- **Immutability**: All instances are immutable once created
+- **Validation**: Values are validated against their type annotations at creation time
+
+### Creating State Instances
+
+State instances are created using standard constructor syntax:
+
+```python
+from uuid import uuid4
+from datetime import datetime
+
+user = User(
+    id=uuid4(),
+    name="Alice Smith",
+    created_at=datetime.now()
+)
+```
+
+All required attributes must be provided, and all values are validated against their type annotations. If a value fails validation, an exception will be raised.
+
+### Immutability and Updates
+
+State instances are immutable, so you cannot modify them directly:
+
+```python
+user.name = "Bob"  # Raises AttributeError
+```
+
+Instead, create new instances with updated values using the `updated` method:
+
+```python
+updated_user = user.updated(name="Bob Smith")
+```
+
+This creates a new instance with the updated value, leaving the original instance unchanged. The `updated` method accepts keyword arguments for any attributes you want to change.
+
+### Path-Based Updates
+
+For nested updates, you can use the path-based `updating` method:
+
+```python
+class Address(State):
+    street: str
+    city: str
+    postal_code: str
+
+class Contact(State):
+    name: str
+    address: Address
+
+# Create an instance
+contact = Contact(
+    name="Alice",
+    address=Address(
+        street="123 Main St",
+        city="Springfield",
+        postal_code="12345"
+    )
+)
+
+# Update a nested value using path syntax
+updated_contact = contact.updating(Contact._.address.city, "New City")
+```
+
+The `Class._.attribute` syntax creates an `AttributePath` that can be used to update nested attributes.
+
+### Generic State Classes
+
+State supports generic type parameters, allowing you to create reusable containers:
+
+```python
+from typing import Generic, TypeVar
+
+T = TypeVar('T')
+
+class Container(State, Generic[T]):
+    value: T
+
+# Create specialized instances
+int_container = Container[int](value=42)
+str_container = Container[str](value="hello")
+```
+
+The type parameter is enforced during validation:
+
+```python
+int_container.updated(value="string")  # Raises TypeError
+```
+
+### Conversion to Dictionary
+
+You can convert a State instance to a dictionary using the `to_mapping` method:
+
+```python
+user_dict = user.to_mapping()
+# {"id": UUID('...'), "name": "Alice Smith", "email": None, "created_at": datetime(...)}
+
+# For nested conversion
+user_dict = user.to_mapping(recursive=True)
+```
+
+This is useful for serialization or when you need to work with plain dictionaries.
+
+### Type Validation
+
+State classes perform thorough type validation for all supported Python types:
+
+- **Basic Types**: int, str, bool, float, bytes
+- **Container Types**: 
+  - **Sequence[T]**: Use `Sequence[T]` instead of `list[T]` - converted to immutable tuples
+  - **Mapping[K, V]**: Use `Mapping[K, V]` instead of `dict[K, V]` - remains as dict
+  - **Set[T]**: Use `Set[T]` instead of `set[T]` - converted to immutable frozensets
+  - **tuple[T, ...]**: Fixed or variable-length tuples
+- **Special Types**: UUID, datetime, date, time, timedelta, timezone, Path, re.Pattern
+- **Union Types**: str | None, int | float
+- **Literal Types**: Literal["a", "b", "c"]
+- **Enum Types**: Standard Enum and StrEnum classes
+- **Callable Types**: Function types and Protocol interfaces
+- **TypedDict**: Validates structure with Required/NotRequired fields
+- **Nested State Classes**: Validates recursively including generic State types
+- **Any Type**: Accepts any value without validation
+
+#### Important Typing Requirements
+
+**Always use abstract collection types instead of concrete types:**
+
+```python
+# ✅ Correct - Use abstract types
+from collections.abc import Sequence, Mapping, Set
+
+class Config(State):
+    items: Sequence[str]        # Not list[str]
+    data: Mapping[str, int]     # Not dict[str, int] 
+    tags: Set[str]              # Not set[str]
+
+# ✅ Lists are converted to tuples (immutable)
+config = Config(
+    items=["a", "b", "c"],      # Becomes ("a", "b", "c")
+    data={"key": 1},            # Remains {"key": 1}
+    tags={"tag1", "tag2"}       # Becomes frozenset({"tag1", "tag2"})
+)
+
+# ❌ Incorrect - Don't use concrete types
+class BadConfig(State):
+    items: list[str]            # Will cause validation errors
+    data: dict[str, int]        # Will cause validation errors
+    tags: set[str]              # Will cause validation errors
+```
+
+This requirement ensures immutability and type safety within the State system.
+
+### Best Practices
+
+1. **Use Immutability**: Embrace the immutable nature of State - never try to modify instances.
+2. **Make Small States**: Keep State classes focused on a single concern.
+3. **Provide Defaults**: Use default values for optional attributes to make creation easier.
+4. **Use Type Annotations**: Always provide accurate type annotations for all attributes.
+5. **Consistent Updates**: Always use `updated` or `updating` methods for changes.
+6. **Composition**: Compose complex states from simpler ones.
+
+### Example: Complex State Management
+
+Here's a more complete example showing complex state management:
+
+```python
+from haiway import State
+from uuid import UUID, uuid4
+from datetime import datetime
+from collections.abc import Sequence
+
+class Address(State):
+    street: str
+    city: str
+    country: str = "USA"
+
+class Contact(State):
+    email: str
+    phone: str | None = None
+
+class User(State):
+    id: UUID
+    name: str
+    address: Address
+    contact: Contact
+    roles: Sequence[str] = ()
+    active: bool = True
+    created_at: datetime
+    updated_at: datetime
+
+# Create an instance
+user = User(
+    id=uuid4(),
+    name="Alice Smith",
+    address=Address(
+        street="123 Main St",
+        city="Springfield",
+    ),
+    contact=Contact(
+        email="alice@example.com",
+    ),
+    created_at=datetime.now(),
+    updated_at=datetime.now(),
+)
+
+# Update a simple attribute
+user1 = user.updated(name="Alice Johnson")
+
+# Update a nested attribute
+user2 = user.updating(User._.address.city, "New City")
+
+# Update multiple attributes
+user3 = user.updated(
+    active=False,
+    updated_at=datetime.now(),
+)
+
+# Update a nested attribute directly
+new_address = user.address.updated(street="456 Oak Ave")
+user4 = user.updated(address=new_address)
+
+# Chain updates
+user5 = user.updated(name="Bob").updating(User._.contact.phone, "555-1234")
+```
+
+### Performance Considerations
+
+While State instances are immutable, creating new instances for updates has minimal overhead as only the changed paths are reconstructed. The validation system is optimized to be fast for typical use cases.
+
+For high-performance scenarios:
+- Keep State classes relatively small and focused
+- Consider using path-based updates for nested changes
+- If needed, batch multiple updates into a single `updated` call
+
+### Integration with Haiway Context
+
+State classes are designed to work seamlessly with Haiway's context system:
+
+```python
+from haiway import ctx, State
+
+class AppConfig(State):
+    debug: bool = False
+    log_level: str = "INFO"
+
+async def main():
+    # Provide state to context
+    async with ctx.scope("main", AppConfig(debug=True)):
+        # Access state from context
+        config = ctx.state(AppConfig)
+        
+        # Create updated state in nested context
+        async with ctx.scope("debug", config.updated(log_level="DEBUG")):
+            # Use updated state
+            debug_config = ctx.state(AppConfig)
+            assert debug_config.log_level == "DEBUG"
+```
+
+This pattern enables effective dependency injection and state propagation throughout your application.

{haiway-0.21.1 → haiway-0.21.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="105" time="1.822" timestamp="2025-05-22T14:52:29.443450+00:00" hostname="pkrvmf6wy0o8zjz"><testcase classname="tests.test_async_queue" name="test_fails_when_stream_fails" time="0.002" /><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_attribute_requirement" name="test_equal_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_not_equal_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_contains_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_contains_any_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_contained_in_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_logical_and_or_requirements" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_filter" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_immutability" 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.001" /><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.000" /><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_process_concurrently" name="test_processes_all_elements" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_processes_elements_concurrently" time="0.302" /><testcase classname="tests.test_process_concurrently" name="test_handles_empty_source" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_propagates_handler_exceptions" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_ignores_handler_exceptions_when_configured" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_handles_source_exception" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_cancels_running_tasks_on_cancellation" time="0.101" /><testcase classname="tests.test_process_concurrently" name="test_respects_concurrency_limit" time="0.202" /><testcase classname="tests.test_process_concurrently" name="test_processes_elements_from_queue" time="0.052" /><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.001" /><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="126" time="1.863" timestamp="2025-05-23T15:40:02.453645+00:00" hostname="pkrvmf6wy0o8zjz"><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_attribute_requirement" name="test_equal_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_not_equal_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_contains_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_contains_any_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_contained_in_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_logical_and_or_requirements" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_filter" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_immutability" 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.001" /><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.000" /><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_process_concurrently" name="test_processes_all_elements" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_processes_elements_concurrently" time="0.302" /><testcase classname="tests.test_process_concurrently" name="test_handles_empty_source" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_propagates_handler_exceptions" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_ignores_handler_exceptions_when_configured" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_handles_source_exception" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_cancels_running_tasks_on_cancellation" time="0.101" /><testcase classname="tests.test_process_concurrently" name="test_respects_concurrency_limit" time="0.201" /><testcase classname="tests.test_process_concurrently" name="test_processes_elements_from_queue" time="0.052" /><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.001" /><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.001" /><testcase classname="tests.test_state_validation" name="test_validator_basic_types" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_none_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_missing_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_literal_type" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_enum_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_sequence_type" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_set_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_mapping_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_tuple_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_union_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_callable_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_typed_dict" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_state_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_complex_types" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_recursive_state" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_generic_state" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validation_error_messages" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validation_any_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_with_defaults" time="0.000" /><testcase classname="tests.test_state_validation" name="test_attribute_validator_direct_usage" time="0.000" /><testcase classname="tests.test_state_validation" name="test_unsupported_type_annotation" 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>

{haiway-0.21.1 → haiway-0.21.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.21.1"
+version = "0.21.2"
 readme = "README.md"
 maintainers = [
   { name = "Kacper Kaliński", email = "kacper.kalinski@miquido.com" },

{haiway-0.21.1 → haiway-0.21.2}/src/haiway/context/access.py

@@ -302,7 +302,7 @@ class ctx:
     def scope(
         label: str,
         /,
-        *state: State,
+        *state: State | None,
         disposables: Disposables | Iterable[Disposable] | None = None,
         task_group: TaskGroup | None = None,
         observability: Observability | Logger | None = None,
@@ -316,7 +316,7 @@ class ctx:
         label: str
             name of the scope context
 
-        *state: State | Disposable
+        *state: State | None
             state propagated within the scope context, will be merged with current state by\
              replacing current with provided on conflict.
 
@@ -355,14 +355,14 @@ class ctx:
         return ScopeContext(
             label=label,
             task_group=task_group,
-            state=state,
+            state=tuple(element for element in state if element is not None),
             disposables=resolved_disposables,
             observability=observability,
         )
 
     @staticmethod
     def updated(
-        *state: State,
+        *state: State | None,
     ) -> StateContext:
         """
         Update scope context with given state. When called within an existing context\
@@ -370,7 +370,7 @@ class ctx:
 
         Parameters
         ----------
-        *state: State
+        *state: State | None
             state propagated within the updated scope context, will be merged with current if any\
              by replacing current with provided on conflict
 
@@ -380,7 +380,7 @@ class ctx:
             state part of context object intended to enter context manager with it
         """
 
-        return StateContext.updated(state)
+        return StateContext.updated(element for element in state if element is not None)
 
     @staticmethod
     def spawn[Result, **Arguments](