fix Documentation builds

Author: HosseinNejatiJavaremi

archipy/adapters/keycloak/adapters.py

@@ -1369,7 +1369,7 @@ def check_permissions(self, token: str, resource: str, scope: str) -> bool:
             return False
 
     @override
-    def create_realm(self, realm_name: str, skip_exists: bool = True, **kwargs) -> dict[str, Any] | None:
+    def create_realm(self, realm_name: str, skip_exists: bool = True, **kwargs: Any) -> dict[str, Any] | None:
         """Create a Keycloak realm with minimum required fields and optional additional config.
 
         Args:
@@ -1433,7 +1433,7 @@ def create_client(
         client_id: str,
         realm: str | None = None,
         skip_exists: bool = True,
-        **kwargs,
+        **kwargs: Any,
     ) -> dict[str, Any] | None:
         """Create a Keycloak client with minimum required fields and optional additional config.
 
@@ -2650,7 +2650,7 @@ async def check_permissions(self, token: str, resource: str, scope: str) -> bool
             return False
 
     @override
-    async def create_realm(self, realm_name: str, skip_exists: bool = True, **kwargs) -> dict[str, Any] | None:
+    async def create_realm(self, realm_name: str, skip_exists: bool = True, **kwargs: Any) -> dict[str, Any] | None:
         """Create a Keycloak realm with minimum required fields and optional additional config.
 
         Args:
@@ -2720,7 +2720,7 @@ async def create_client(
         client_id: str,
         realm: str | None = None,
         skip_exists: bool = True,
-        **kwargs,
+        **kwargs: Any,
     ) -> dict[str, Any] | None:
         """Create a Keycloak client with minimum required fields and optional additional config.
 

archipy/helpers/decorators/retry.py

@@ -26,7 +26,6 @@ def retry_decorator(
         ignore (Optional[Tuple[Type[Exception], ...]]): A tuple of errors to ignore (not retry on).
             If None, no errors are ignored. Defaults to None.
         resource_type (Optional[str]): The type of resource being exhausted. Defaults to None.
-        lang (str): The language for the error message (default: "fa").
 
     Returns:
         Callable: The decorated function with retry logic.

archipy/helpers/utils/password_utils.py

@@ -72,7 +72,6 @@ def validate_password(
         Args:
             password (str): The password to validate.
             auth_config (AuthConfig | None): Optional auth configuration override. If not provided, uses the global config.
-            lang (LanguageType): The language to use for error messages. Defaults to Persian.
 
         Raises:
             InvalidPasswordError: If the password does not meet the policy requirements.

archipy/models/types/base_types.py

@@ -7,7 +7,7 @@ class BaseType(Enum):
     This class extends the `Enum` class to allow custom values for enum members.
     """
 
-    def __new__(cls, *args: object, **_: object) -> "BaseType":
+    def __new__(cls: type["BaseType"], *args: object, **_: object) -> "BaseType":
         """Create a new instance of the enum member.
 
         Args:

docs/api_reference/adapters.md

@@ -325,3 +325,85 @@ For detailed examples and usage guidelines, see the [Parsian Payment Gateway Exa
 options:
 show_root_heading: true
 show_source: true
+
+### Temporal {#temporal}
+
+Temporal workflow orchestration adapter for durable workflow execution and activity coordination.
+
+```python
+from archipy.adapters.temporal.adapters import TemporalAdapter
+from archipy.adapters.temporal.worker import TemporalWorkerManager
+from archipy.adapters.temporal.base import BaseWorkflow, BaseActivity
+
+# Create a Temporal adapter
+temporal_adapter = TemporalAdapter()  # Uses global config by default
+
+# Start a workflow execution
+workflow_handle = await temporal_adapter.start_workflow(
+    workflow="MyWorkflow",
+    arg={"input": "data"},
+    workflow_id="unique-workflow-id",
+    task_queue="my-task-queue"
+)
+
+# Execute a workflow and wait for completion
+result = await temporal_adapter.execute_workflow(
+    workflow="MyWorkflow",
+    arg={"input": "data"},
+    workflow_id="unique-workflow-id-2",
+    task_queue="my-task-queue"
+)
+
+# Signal a workflow
+await temporal_adapter.signal_workflow(
+    workflow_id="unique-workflow-id",
+    signal_name="update_signal",
+    arg={"update": "data"}
+)
+
+# Query a workflow
+query_result = await temporal_adapter.query_workflow(
+    workflow_id="unique-workflow-id",
+    query_name="get_status"
+)
+
+# Worker management
+worker_manager = TemporalWorkerManager()
+
+# Start a worker
+worker_handle = await worker_manager.start_worker(
+    task_queue="my-task-queue",
+    workflows=[MyWorkflow],
+    activities=[my_activity_instance]
+)
+```
+
+For detailed examples and usage guidelines, see the [Temporal Examples](../examples/adapters/temporal.md).
+
+#### Temporal Adapter
+
+::: archipy.adapters.temporal.adapters
+options:
+show_root_heading: true
+show_source: true
+
+#### Temporal Ports
+
+::: archipy.adapters.temporal.ports
+options:
+show_root_heading: true
+show_source: true
+
+#### Temporal Worker Manager
+
+::: archipy.adapters.temporal.worker
+options:
+show_root_heading: true
+show_source: true
+
+#### Temporal Base Classes
+
+::: archipy.adapters.temporal.base
+options:
+show_root_heading: true
+show_source: true

docs/api_reference/configs.md

@@ -27,7 +27,7 @@ class AppConfig(BaseConfig):
 
 ## Core Classes
 
-### BaseConfig
+### BaseConfig {#base-config}
 
 The main configuration class that provides environment variable support, type validation, and global configuration access.
 
@@ -37,7 +37,7 @@ The main configuration class that provides environment variable support, type va
 - Global configuration access
 - Nested configuration support
 
-### SQLAlchemyConfig
+### SQLAlchemyConfig {#config-templates}
 
 Database configuration template with connection settings, pool configuration, and debug options.
 

mkdocs.yml

@@ -121,6 +121,7 @@ nav:
       - Keycloak: examples/adapters/keycloak.md
       - MinIO: examples/adapters/minio.md
       - Kafka: examples/adapters/kafka.md
+      - Temporal: examples/adapters/temporal.md
       - Payment Gateways: examples/adapters/parsian_payment.md
     - Helpers:
       - Overview: examples/helpers/index.md