biased 0.1.2.dev13__tar.gz → 0.2.0.dev1__tar.gz

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/PKG-INFO

@@ -1,23 +1,26 @@
 Metadata-Version: 2.3
 Name: biased
-Version: 0.1.2.dev13
+Version: 0.2.0.dev1
 Summary: Various reusable components, helpers, and utilities which I would like to use in any Python project
 Author: Dmitry Tatarkin
 Author-email: Dmitry Tatarkin <tatarkin@gmail.com>
-Requires-Dist: injector>=0.22.0
+Requires-Dist: injector
 Requires-Dist: pydantic>=2
-Requires-Dist: python-dateutil>=2.9.0.post0
-Requires-Dist: structlog>=25.4.0
-Requires-Dist: ulid-py>=1.1.0
-Requires-Dist: django>=5.2.6 ; extra == 'django'
-Requires-Dist: django-jsonform>=2.23.2 ; extra == 'django-jsonform'
-Requires-Dist: django-redis>=6.0.0 ; extra == 'django-redis'
-Requires-Dist: django-ninja>=1.4.3 ; extra == 'ninja'
+Requires-Dist: python-dateutil
+Requires-Dist: structlog
+Requires-Dist: ulid-py
+Requires-Dist: python-dotenv[cli]
+Requires-Dist: django ; extra == 'django'
+Requires-Dist: django-jsonform ; extra == 'django-jsonform'
+Requires-Dist: django-redis ; extra == 'django-redis'
+Requires-Dist: django-ninja ; extra == 'ninja'
+Requires-Dist: temporalio ; extra == 'temporal'
 Requires-Python: >=3.12
 Provides-Extra: django
 Provides-Extra: django-jsonform
 Provides-Extra: django-redis
 Provides-Extra: ninja
+Provides-Extra: temporal
 Description-Content-Type: text/markdown
 
 # About

biased-0.2.0.dev1/pyproject.toml

@@ -0,0 +1,76 @@
+[project]
+name = "biased"
+version = "0.2.0.dev1"
+description = "Various reusable components, helpers, and utilities which I would like to use in any Python project"
+readme = "README.md"
+authors = [
+    { name = "Dmitry Tatarkin", email = "tatarkin@gmail.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "injector",
+    "pydantic>=2",
+    "python-dateutil",
+    "structlog",
+    "ulid-py",
+    "python-dotenv[cli]",
+]
+
+[project.scripts]
+dotenv-run = "biased.scripts.dotenv_run:main"
+
+[project.optional-dependencies]
+django = [
+    "django",
+]
+ninja = [
+    "django-ninja",
+]
+django-redis = [
+    "django-redis",
+]
+django-jsonform = [
+    "django-jsonform",
+]
+temporal = [
+    "temporalio",
+]
+
+[build-system]
+requires = ["uv_build>=0.8.16,<0.9.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest",
+    "rust-just",
+    "python-dotenv",
+]
+
+lint = [
+    "bandit",
+    "django-stubs[compatible-mypy]",
+    "mypy",
+    "pre-commit",
+    "pyright",
+    "ruff",
+    "types-python-dateutil",
+]
+
+
+[tool.bandit.assert_used]
+skips = ["**/test_*.py"]
+
+[tool.mypy]
+packages = ["biased"]
+
+[[tool.mypy.overrides]]
+module = [
+    "multiselectfield.*",
+    "jsoneditor.*",
+    "pydantic_settings.*",
+    "django_redis.*",
+    "ninja.*",
+    "admin_form_action.*",
+]
+ignore_missing_imports = true

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django/admin.py

@@ -45,7 +45,7 @@ def admin_change_link(short_description: str, empty_description: str = "-"):
                 return empty_description
             return admin_change_html_link(instance=related_obj)
 
-        field_func.short_description = short_description
+        field_func.short_description = short_description  # type: ignore[attr-defined]
         return field_func
 
     return wrapper
@@ -63,7 +63,7 @@ def id_admin_change_link(
                 app_label=app_label, model_name=model_name, object_id=object_id, id_slug=id_slug
             )
 
-        field_func.short_description = short_description
+        field_func.short_description = short_description  # type: ignore[attr-defined]
         return field_func
 
     return wrapper
@@ -93,7 +93,7 @@ def admin_query_params_list_link(
                 model_type=model_type, title=title, query_kwargs=query_params, target=target
             )
 
-        field_func.short_description = short_description
+        field_func.short_description = short_description  # type: ignore[attr-defined]
         return field_func
 
     return wrapper
@@ -103,7 +103,7 @@ def _build_html_image_tag(url: str, attributes: dict[str, Any] | None = None) ->
     if attributes:
         attributes_html = mark_safe(" ".join(f'{attr}="{value}"' for attr, value in attributes.items()))  # nosec B308:blacklist, B703:django_mark_safe
     else:
-        attributes_html = ""
+        attributes_html = mark_safe("")  # nosec B308:blacklist, B703:django_mark_safe
     return format_html('<img src="{url}" {attributes_html}/>', url=url, attributes_html=attributes_html)
 
 
@@ -115,7 +115,7 @@ def html_image_tag(short_description: str, attributes: dict[str, Any] | None = N
                 return empty_description
             return _build_html_image_tag(url=image_url, attributes=attributes)
 
-        field_func.short_description = short_description
+        field_func.short_description = short_description  # type: ignore[attr-defined]
         return field_func
 
     return wrapper
@@ -132,7 +132,7 @@ def url_link(short_description: str, content: str = "-", target: str = "_self"):
                 params.update(func(self, obj))
                 return format_html('<a href="{url}" target="{target}">{content}</a>', **params)
 
-        field_func.short_description = short_description
+        field_func.short_description = short_description  # type: ignore[attr-defined]
         return field_func
 
     return wrapper

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django/aws_waf/aws_waf_regex_pattern.py

@@ -36,9 +36,9 @@ def validate_aws_waf_regex_patterns(
 
     for regex_pattern, url in iter_regex_patterns(url_patterns):
         for url_template, url_params in normalize(regex_pattern):
-            url_params = set(url_params)
+            url_params_set = set(url_params)
             with context(url=url):
-                remaining_params = url_params - context.keys()
+                remaining_params = url_params_set - context.keys()
                 if not remaining_params:
                     url_example = "/" + url_template % context
                     if search_aws_waf_pattern(url_example=url_example) is None:

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django/aws_waf/aws_waf_whitelist_middleware.py

@@ -1,5 +1,5 @@
 from abc import ABC, abstractmethod
-from collections.abc import Callable, Sequence
+from collections.abc import Sequence
 
 from asgiref.sync import iscoroutinefunction, markcoroutinefunction
 from django.conf import settings
@@ -9,7 +9,7 @@ from django.http import HttpRequest, HttpResponse
 from biased.django.aws_waf.aws_waf_regex_pattern import AwsWafRegexPatternSet
 
 
-class AwsWafWhitelistMiddleware(ABC, Callable[[HttpRequest], HttpResponse]):
+class AwsWafWhitelistMiddleware(ABC):
     async_capable = True
     sync_capable = False
     aws_waf_regex_pattern_sets: Sequence[AwsWafRegexPatternSet] = tuple()

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django/aws_waf/url_patterns.py

@@ -2,11 +2,11 @@ from collections.abc import Iterable, Sequence
 from typing import Any
 
 from django.urls import URLPattern, URLResolver
-from django.urls.resolvers import RoutePattern
+from django.urls.resolvers import RegexPattern, RoutePattern
 
 
 class UrlArgsContext:
-    def __init__(self, *args: Sequence[tuple[str, dict[str, Any]]]) -> None:
+    def __init__(self, *args: tuple[Sequence[str], dict[str, Any]]) -> None:
         self._urls: list[str] = [""]
         self._args = args
 
@@ -28,7 +28,7 @@ class UrlArgsContext:
     def __exit__(self, exc_type, exc_val, exc_tb):
         self._urls.pop()
 
-    def keys(self):
+    def keys(self) -> set[str]:
         keys: set[str] = set()
         for prefixes, params in self._args:
             for prefix in prefixes:
@@ -53,9 +53,10 @@ def _iter_url_patterns(
             raise RuntimeError(f"Unexpected url_pattern type: {type(url_pattern)}")
 
 
-def _iter_route_patterns(url_patterns: Iterable[RoutePattern | URLPattern]) -> Iterable[tuple[RoutePattern, ...]]:
+def _iter_route_patterns(url_patterns: Iterable[RoutePattern | URLPattern]) -> Iterable[RoutePattern | RegexPattern]:
     for url_pattern in url_patterns:
         if isinstance(url_pattern, URLPattern):
+            assert isinstance(url_pattern.pattern, (RoutePattern | RegexPattern))  # nosec B101
             yield url_pattern.pattern
         elif isinstance(url_pattern, RoutePattern):
             yield url_pattern
@@ -63,15 +64,15 @@ def _iter_route_patterns(url_patterns: Iterable[RoutePattern | URLPattern]) -> I
             raise RuntimeError(f"Unexpected url_pattern type: {type(url_pattern)}")
 
 
-def _route_pattern_to_regex_pattern(route_pattern: RoutePattern) -> str:
+def _route_pattern_to_regex_pattern(route_pattern: RoutePattern | RegexPattern) -> str:
     return route_pattern.regex.pattern.removeprefix("^").replace("/", r"\/")
 
 
-def _route_patterns_to_regex_pattern(route_patterns: Iterable[RoutePattern]) -> str:
+def _route_patterns_to_regex_pattern(route_patterns: Iterable[RoutePattern | RegexPattern]) -> str:
     return "^" + "".join(map(_route_pattern_to_regex_pattern, route_patterns))
 
 
-def _route_patterns_to_str(route_patterns: Iterable[RoutePattern]) -> str:
+def _route_patterns_to_str(route_patterns: Iterable[RoutePattern | RegexPattern]) -> str:
     return "".join(map(str, route_patterns))
 
 

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django/filters/entity_filter.py

@@ -40,9 +40,12 @@ class EntityFilter(CommaSeparatedInputFilter):
     def value_to_filter(self, value: str) -> Q:
         value_type, parsed_value = _parse_value(value=value)
         if value_type == ValueType.int:
+            assert isinstance(parsed_value, int)  # nosec B101
             return self.int_value_to_filter(value=parsed_value)
         if value_type == ValueType.ulid:
+            assert isinstance(parsed_value, str)  # nosec B101
             return self.ulid_value_to_filter(value=parsed_value)
         if value_type == ValueType.str:
+            assert isinstance(parsed_value, str)  # nosec B101
             return self.str_value_to_filter(value=parsed_value)
         raise NotImplementedError(f"{value_type} is not supported")

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django/filters/input_filter.py

@@ -1,25 +1,28 @@
 import operator
 from abc import ABC, abstractmethod
+from collections.abc import Iterator
 from functools import reduce
 
-from django.contrib.admin import SimpleListFilter
-from django.db.models import Q
+from django.contrib.admin import ModelAdmin, SimpleListFilter
+from django.contrib.admin.views.main import ChangeList
+from django.db.models import Q, QuerySet
+from django.http import HttpRequest
 
 
 class InputFilter(SimpleListFilter):
     template = "admin/input_filter.html"
 
-    def lookups(self, request, model_admin):
+    def lookups(self, request: HttpRequest, model_admin: ModelAdmin) -> tuple[tuple[()], ...]:  # type: ignore[override]
         # Dummy, required to show the filter.
         return ((),)
 
-    def get_facet_counts(self, pk_attname, filtered_qs):
+    def get_facet_counts(self, pk_attname: str, filtered_qs: QuerySet) -> dict:
         return {}
 
-    def choices(self, changelist):
+    def choices(self, changelist: ChangeList) -> Iterator:
         # Grab only the "all" option.
         all_choice = next(super().choices(changelist))
-        all_choice["query_parts"] = (
+        all_choice["query_parts"] = (  # type: ignore[typeddict-unknown-key]
             (k, v) for k, values in changelist.get_filters_params().items() for v in values if k != self.parameter_name
         )
         yield all_choice
@@ -30,10 +33,11 @@ class CommaSeparatedInputFilter(InputFilter, ABC):
     def value_to_filter(self, value: str) -> Q:
         pass
 
-    def queryset(self, request, queryset):
-        if self.value() is not None:
+    def queryset(self, request: HttpRequest, queryset: QuerySet) -> QuerySet | None:
+        filter_value = self.value()
+        if filter_value is not None:
             filters: list[Q] = []
-            for i in self.value().split(","):
+            for i in filter_value.split(","):
                 value = i.strip()
                 if not value:
                     continue
@@ -46,10 +50,11 @@ class CommaSeparatedInputFilter(InputFilter, ABC):
 class StrArrayInputFilter(InputFilter):
     query_name: str
 
-    def queryset(self, request, queryset):
-        if self.value() is not None:
+    def queryset(self, request: HttpRequest, queryset: QuerySet) -> QuerySet | None:
+        filter_value = self.value()
+        if filter_value is not None:
             items: list[str] = []
-            for i in self.value().split(","):
+            for i in filter_value.split(","):
                 value = i.strip()
                 if not value:
                     continue

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django/models/created_at_modified_at_mixin.py

@@ -2,8 +2,8 @@ from django.db import models
 
 
 class CreatedAtModifiedAtMixin(models.Model):
-    created_at = models.DateTimeField(auto_now_add=True, editable=False)
-    modified_at = models.DateTimeField(auto_now=True, editable=False)
+    created_at = models.DateTimeField(auto_now_add=True, editable=False)  # type: ignore[var-annotated]
+    modified_at = models.DateTimeField(auto_now=True, editable=False)  # type: ignore[var-annotated]
 
     class Meta:
         abstract = True

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django/models/deleted_at_mixin.py

@@ -8,12 +8,12 @@ class DeletedAtQuerySet(models.QuerySet):
         return self.filter(deleted_at__isnull=True)
 
 
-class DeletedAtManager(models.Manager.from_queryset(DeletedAtQuerySet)):
+class DeletedAtManager(models.Manager.from_queryset(DeletedAtQuerySet)):  # type: ignore[misc]
     pass
 
 
 class DeletedAtMixin(models.Model):
-    deleted_at = models.DateTimeField(null=True, blank=True)
+    deleted_at = models.DateTimeField(null=True, blank=True)  # type: ignore[var-annotated]
 
     objects = DeletedAtManager()
 

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django/utils/choices.py

@@ -10,4 +10,4 @@ def enum_to_choices(enum: type[Enum]) -> Iterable[tuple[str, str]]:
 
 def choices_to_text_choices(enum_name: str, choices: Iterable[tuple[str, str]]) -> TextChoices:
     attrs = {value: (value, label) for value, label in choices}
-    return TextChoices(enum_name, attrs)
+    return TextChoices(enum_name, attrs)  # type: ignore[call-overload]

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django/utils/get_client_ip.py

@@ -1,7 +1,7 @@
 from django.http import HttpRequest
 
 
-def get_client_ip(request: HttpRequest) -> str:
+def get_client_ip(request: HttpRequest) -> str | None:
     x_forwarded_for = request.META.get("HTTP_X_FORWARDED_FOR")
     if x_forwarded_for:
         ip = x_forwarded_for.split(",")[0]

{biased-0.1.2.dev13 → biased-0.2.0.dev1}/src/biased/django_jsonform/jsonform_action.py

@@ -1,14 +1,9 @@
-from typing import TypeVar
-
 from admin_form_action import Decorator, form_action
 from django import forms
 from django.contrib.admin import ModelAdmin
 
-FormT = TypeVar("FormT", bound=forms.Form)
-ModelAdminT = TypeVar("ModelAdminT", bound=ModelAdmin)
-
 
-def jsonform_action[FormT: forms.Form](
+def jsonform_action[FormT: forms.Form, ModelAdminT: ModelAdmin](
     form_class: type[FormT],
     *,
     template: str | None = None,

biased-0.2.0.dev1/src/biased/scripts/dotenv_run.py

@@ -0,0 +1,45 @@
+#!/usr/bin/env python3
+import argparse
+import os
+
+from dotenv import load_dotenv
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Load environment variables from files and run a command.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="Example:\n  dotenv-run -f .env -f .env.local -- python manage.py runserver",
+    )
+    parser.add_argument(
+        "-f",
+        "--file",
+        dest="files",
+        action="append",
+        default=[],
+        help="Path to the .env file to load. Can be specified multiple times.",
+    )
+    parser.add_argument(
+        "command",
+        nargs=argparse.REMAINDER,
+        help="Command to execute, followed by its arguments.",
+    )
+
+    args = parser.parse_args()
+
+    for f in args.files:
+        load_dotenv(f, override=True)
+
+    if args.command and args.command[0] == "--":
+        cmd_args = args.command[1:]
+    else:
+        cmd_args = args.command
+
+    if not cmd_args:
+        parser.error("No command specified to execute.")
+
+    os.execvp(cmd_args[0], cmd_args)  # nosec B606:start_process_with_no_shell
+
+
+if __name__ == "__main__":
+    main()

biased-0.2.0.dev1/src/biased/temporal/activities/consts.py

@@ -0,0 +1,11 @@
+from datetime import timedelta
+
+from temporalio.common import RetryPolicy
+
+DEFAULT_START_TO_CLOSE_TIMEOUT = timedelta(seconds=30)
+
+DEFAULT_RETRY_POLICY = RetryPolicy(
+    initial_interval=timedelta(seconds=5),
+    backoff_coefficient=2,
+    maximum_interval=timedelta(days=1),
+)

biased-0.2.0.dev1/src/biased/temporal/activities/dtos.py

@@ -0,0 +1,11 @@
+from pydantic import StrictStr
+
+from biased.dtos.base import BaseDto
+
+
+class EchoActivityArg(BaseDto):
+    message: StrictStr
+
+
+class EchoActivityResult(BaseDto):
+    message: StrictStr

biased-0.2.0.dev1/src/biased/temporal/activities/echo.py

@@ -0,0 +1,12 @@
+from datetime import timedelta
+
+from temporalio import activity
+
+from biased.temporal.activities.dtos import EchoActivityArg, EchoActivityResult
+from biased.temporal.activities.utils import with_default_execute_params
+
+
+@activity.defn(name="echo")
+@with_default_execute_params(start_to_close_timeout=timedelta(seconds=3))
+async def echo_activity(arg: EchoActivityArg) -> EchoActivityResult:
+    return EchoActivityResult(message=arg.message)

biased-0.2.0.dev1/src/biased/temporal/activities/types.py

@@ -0,0 +1,16 @@
+from collections.abc import Awaitable
+from datetime import timedelta
+from typing import Protocol
+
+from temporalio.common import RetryPolicy
+
+from biased.dtos.base import BaseDto
+
+
+class ActivityFuncWrapper[ArgT: BaseDto, ResultT: BaseDto](Protocol):
+    """Protocol for activity functions decorated with with_default_execute_params."""
+
+    default_start_to_close_timeout: timedelta
+    default_retry_policy: RetryPolicy | None
+
+    def __call__(self, arg: ArgT, /) -> Awaitable[ResultT]: ...

biased-0.2.0.dev1/src/biased/temporal/activities/utils.py

@@ -0,0 +1,50 @@
+from collections.abc import Awaitable, Callable
+from datetime import timedelta
+from typing import cast
+
+from temporalio.common import RetryPolicy
+
+from biased.dtos.base import BaseDto
+from biased.temporal.activities.consts import DEFAULT_START_TO_CLOSE_TIMEOUT
+from biased.temporal.activities.types import ActivityFuncWrapper
+
+
+def with_default_execute_params[ArgT: BaseDto, ResultT: BaseDto](
+    start_to_close_timeout: timedelta = DEFAULT_START_TO_CLOSE_TIMEOUT,
+    retry_policy: RetryPolicy | None = None,
+) -> Callable[[Callable[[ArgT], Awaitable[ResultT]]], ActivityFuncWrapper[ArgT, ResultT]]:
+    """Decorator to set default execution parameters on an activity function.
+
+    Sets `default_start_to_close_timeout` and optionally `default_retry_policy`
+    attributes on the activity function for use with `workflow.execute_activity()`.
+
+    Args:
+        start_to_close_timeout: Default timeout for the activity (default: DEFAULT_START_TO_CLOSE_TIMEOUT).
+        retry_policy: Optional default retry policy for the activity.
+
+    Usage:
+        @activity.defn(name="my_activity")
+        @with_default_execute_params(
+            start_to_close_timeout=timedelta(minutes=5),
+            retry_policy=RetryPolicy(
+                initial_interval=timedelta(seconds=1),
+                backoff_coefficient=2,
+                maximum_interval=timedelta(hours=1),
+            ),
+        )
+        async def my_activity(arg: MyActivityArg) -> MyActivityResult:
+            ...
+
+        # Then in workflow:
+        from biased.temporal.workflows.workflow import execute_activity
+
+        await execute_activity(my_activity, arg=MyActivityArg(...))
+    """
+
+    def decorator(func: Callable[[ArgT], Awaitable[ResultT]]) -> ActivityFuncWrapper[ArgT, ResultT]:
+        func = cast(ActivityFuncWrapper[ArgT, ResultT], func)
+        func.default_start_to_close_timeout = start_to_close_timeout
+        func.default_retry_policy = retry_policy
+        return func
+
+    return decorator

biased-0.2.0.dev1/src/biased/temporal/django/admin/trigger_temporal_workflow_mixin.py

@@ -0,0 +1,65 @@
+from typing import Any
+
+from django.contrib import messages
+from django.contrib.admin import ModelAdmin
+from django.http import HttpRequest
+from django.utils.html import format_html
+from temporalio.client import WorkflowHandle
+
+from biased.dtos.base import BaseDto
+from biased.temporal.django.temporal_ui import DjangoTemporalUi
+from biased.temporal.temporal_client_holder import TemporalClientHolder
+from biased.temporal.workflows.base import BaseWorkflow
+from biased.temporal.workflows.workflow import start_workflow
+
+
+class TriggerTemporalWorkflowMixin(ModelAdmin):
+    def _start_temporal_workflow[ArgT: BaseDto, ResultT: BaseDto](
+        self,
+        request: HttpRequest,
+        workflow: type[BaseWorkflow[ArgT, ResultT]],
+        arg: ArgT,
+        django_temporal_ui: DjangoTemporalUi,
+        *,
+        task_queue: str = "default",
+        context: Any = None,
+    ) -> WorkflowHandle:
+        """Start a Temporal workflow from Django admin.
+
+        Args:
+            request: Django HTTP request (must have state["temporal_client_holder"])
+            workflow: Workflow class (must inherit from BaseWorkflow)
+            arg: Workflow argument DTO
+            task_queue: Task queue name
+            context: Optional context to display in the success message
+
+        Returns:
+            WorkflowHandle for the started workflow.
+        """
+        state: dict[str, Any] = getattr(request, "state", {})
+        temporal_client_holder: TemporalClientHolder = state["temporal_client_holder"]
+
+        handle: WorkflowHandle = start_workflow(
+            temporal_client_holder=temporal_client_holder,
+            workflow=workflow,
+            arg=arg,
+            task_queue=task_queue,
+        )
+
+        if context is None:
+            context_str = ""
+        else:
+            context_str = f", {context}"
+        self.message_user(
+            request,
+            message=format_html(
+                "Successfully started Temporal workflow {workflow_html_link}{context_str}",
+                workflow_html_link=django_temporal_ui.build_workflow_html_link(
+                    workflow_id=handle.id, content=workflow.get_workflow_name()
+                ),
+                context_str=context_str,
+            ),
+            level=messages.SUCCESS,
+        )
+
+        return handle

biased-0.2.0.dev1/src/biased/temporal/django/temporal_ui.py

@@ -0,0 +1,11 @@
+from django.utils.html import format_html
+
+from biased.temporal.services.temporal_ui import TemporalUi
+
+
+class DjangoTemporalUi(TemporalUi):
+    def build_workflow_html_link(self, workflow_id: str, content: str | None = None) -> str:
+        url = self.build_workflow_url(workflow_id=workflow_id)
+        if content is None:
+            content = workflow_id
+        return format_html('<a href="{}" target="_blank">{}</a>', str(url), content)

biased-0.2.0.dev1/src/biased/temporal/dtos.py

@@ -0,0 +1,25 @@
+from pydantic import HttpUrl
+from pydantic_settings import SettingsConfigDict
+
+from biased.dtos.base import BaseDto
+from biased.dtos.env_file_paths import EnvFilePathsSettings
+
+
+class TemporalClientParams(BaseDto):
+    target_host: str
+    namespace: str = "default"
+    api_key: str | None = None
+    identity: str | None = None
+    lazy: bool = True
+
+
+class TemporalClientSettings(EnvFilePathsSettings, TemporalClientParams):
+    model_config = SettingsConfigDict(extra="ignore", env_prefix="TEMPORAL_CLIENT_")
+
+
+class TemporalParams(BaseDto):
+    ui_base_url: HttpUrl
+
+
+class TemporalSettings(EnvFilePathsSettings, TemporalParams):
+    model_config = SettingsConfigDict(extra="ignore", env_prefix="TEMPORAL_", env_nested_delimiter="__")

biased-0.2.0.dev1/src/biased/temporal/services/temporal_ui.py

@@ -0,0 +1,21 @@
+from injector import inject
+from pydantic import HttpUrl
+
+from biased.temporal.dtos import TemporalClientParams, TemporalParams
+
+
+class TemporalUi:
+    @inject
+    def __init__(self, temporal_params: TemporalParams, client_params: TemporalClientParams):
+        self._temporal_params = temporal_params
+        self._client_params = client_params
+
+    def build_workflow_url(self, workflow_id: str) -> HttpUrl:
+        base = self._temporal_params.ui_base_url
+        assert base.host is not None  # nosec B101:assert_used
+        return HttpUrl.build(
+            scheme=base.scheme,
+            host=base.host,
+            port=base.port,
+            path=f"namespaces/{self._client_params.namespace}/workflows/{workflow_id}",
+        )

biased-0.2.0.dev1/src/biased/temporal/temporal_client_holder.py

@@ -0,0 +1,25 @@
+from injector import inject
+from temporalio.client import Client
+from temporalio.contrib.pydantic import pydantic_data_converter
+
+from biased.temporal.dtos import TemporalClientParams
+
+
+class TemporalClientHolder:
+    @inject
+    def __init__(self, params: TemporalClientParams) -> None:
+        self._params = params
+        self._client: Client | None = None
+
+    async def get_or_create_temporal_client(self) -> Client:
+        if self._client is None:
+            params = self._params
+            self._client = await Client.connect(
+                params.target_host,
+                namespace=params.namespace,
+                api_key=params.api_key,
+                identity=params.identity,
+                lazy=params.lazy,
+                data_converter=pydantic_data_converter,
+            )
+        return self._client

biased-0.2.0.dev1/src/biased/temporal/workflows/base.py

@@ -0,0 +1,61 @@
+from abc import ABC, abstractmethod
+
+from temporalio.client import Client, WorkflowHandle
+from temporalio.workflow import _Definition
+
+from biased.dtos.base import BaseDto
+from biased.temporal.workflows.utils import get_workflow_definition
+
+
+class BaseWorkflow[ArgT: BaseDto, ResultT: BaseDto](ABC):
+    @classmethod
+    @abstractmethod
+    def build_id(cls, arg: ArgT) -> str:
+        """Generate a unique workflow ID based on the provided arg DTO."""
+        ...
+
+    @classmethod
+    def _get_workflow_definition(cls) -> _Definition:
+        """Get the Temporal workflow definition for this workflow class."""
+        return get_workflow_definition(workflow=cls)
+
+    @classmethod
+    def get_workflow_name(cls) -> str:
+        workflow_definition = cls._get_workflow_definition()
+        assert workflow_definition.name is not None  # nosec B101:assert_used
+        return workflow_definition.name
+
+    @classmethod
+    async def start(
+        cls,
+        client: Client,
+        arg: ArgT,
+        *,
+        task_queue: str = "default",
+        id: str | None = None,
+        **kwargs,
+    ) -> WorkflowHandle:
+        """Start the workflow.
+
+        Args:
+            client: Temporal client
+            arg: Workflow argument DTO
+            task_queue: Task queue name
+            id: Workflow ID. If None, will be generated using build_id
+                by extracting kwargs from arg.model_dump().
+            **kwargs: Additional kwargs passed to client.start_workflow.
+
+        Returns:
+            WorkflowHandle for the started workflow.
+        """
+        workflow_definition = cls._get_workflow_definition()
+        if id is None:
+            id = cls.build_id(arg=arg)
+        handle = await client.start_workflow(
+            workflow_definition.run_fn,
+            arg=arg,
+            id=id,
+            task_queue=task_queue,
+            **kwargs,
+        )
+        return handle

biased-0.2.0.dev1/src/biased/temporal/workflows/dtos.py

@@ -0,0 +1,11 @@
+from pydantic import StrictStr
+
+from biased.dtos.base import BaseDto
+
+
+class EchoWorkflowArg(BaseDto):
+    message: StrictStr
+
+
+class EchoWorkflowResult(BaseDto):
+    message: StrictStr

biased-0.2.0.dev1/src/biased/temporal/workflows/echo.py

@@ -0,0 +1,28 @@
+from temporalio import workflow
+
+from biased.temporal.activities.dtos import EchoActivityArg, EchoActivityResult
+from biased.temporal.activities.echo import echo_activity
+from biased.temporal.workflows.base import BaseWorkflow
+from biased.temporal.workflows.dtos import EchoWorkflowArg, EchoWorkflowResult
+from biased.temporal.workflows.workflow import execute_activity
+
+# Import activity, passing it through the sandbox without reloading the module
+with workflow.unsafe.imports_passed_through():
+    ...
+
+
+@workflow.defn(name="echo")
+class EchoWorkflow(BaseWorkflow[EchoWorkflowArg, EchoWorkflowResult]):
+    @classmethod
+    def build_id(cls, arg: EchoWorkflowArg) -> str:
+        return f"{cls._get_workflow_definition().name}-{arg.message}"
+
+    @workflow.run
+    async def run(self, arg: EchoWorkflowArg) -> EchoWorkflowResult:
+        result: EchoActivityResult = await execute_activity(
+            echo_activity,
+            arg=EchoActivityArg(message=arg.message),
+        )
+        return EchoWorkflowResult(
+            message=result.message,
+        )

biased-0.2.0.dev1/src/biased/temporal/workflows/utils.py

@@ -0,0 +1,7 @@
+from temporalio.types import ClassType
+from temporalio.workflow import _Definition
+
+
+def get_workflow_definition(workflow: ClassType) -> _Definition:
+    workflow_definition: _Definition = getattr(workflow, "__temporal_workflow_definition")
+    return workflow_definition

biased-0.2.0.dev1/src/biased/temporal/workflows/workflow.py

@@ -0,0 +1,73 @@
+from logging import getLogger
+
+from asgiref.sync import async_to_sync
+from temporalio import workflow
+from temporalio.client import WorkflowHandle
+
+from biased.dtos.base import BaseDto
+from biased.temporal.activities.types import ActivityFuncWrapper
+from biased.temporal.temporal_client_holder import TemporalClientHolder
+from biased.temporal.workflows.base import BaseWorkflow
+
+log = getLogger(__name__)
+
+
+async def execute_activity[ArgT: BaseDto, ResultT: BaseDto](
+    activity: ActivityFuncWrapper[ArgT, ResultT],
+    *,
+    arg: ArgT,
+    **kwargs,
+) -> ResultT:
+    return await workflow.execute_activity(
+        activity=activity,
+        arg=arg,
+        start_to_close_timeout=activity.default_start_to_close_timeout,
+        retry_policy=activity.default_retry_policy,
+        **kwargs,
+    )
+
+
+async def execute_child_workflow[ArgT: BaseDto, ResultT: BaseDto](
+    child_workflow: type[BaseWorkflow[ArgT, ResultT]],
+    *,
+    arg: ArgT,
+    **kwargs,
+) -> ResultT:
+    workflow_definition = child_workflow._get_workflow_definition()
+    return await workflow.execute_child_workflow(
+        workflow=workflow_definition.run_fn,
+        arg=arg,
+        id=child_workflow.build_id(arg=arg),
+        **kwargs,
+    )
+
+
+def start_workflow[ArgT: BaseDto, ResultT: BaseDto](
+    temporal_client_holder: TemporalClientHolder,
+    workflow: type[BaseWorkflow[ArgT, ResultT]],
+    arg: ArgT,
+    *,
+    task_queue: str = "default",
+    **kwargs,
+) -> WorkflowHandle:
+    @async_to_sync
+    async def _start() -> WorkflowHandle:
+        workflow_handle = await workflow.start(
+            client=await temporal_client_holder.get_or_create_temporal_client(),
+            arg=arg,
+            task_queue=task_queue,
+            **kwargs,
+        )
+
+        log.info(
+            "started_temporal_workflow",
+            extra=dict(
+                data=dict(
+                    workflow_name=workflow.get_workflow_name(),
+                    workflow_handle_id=workflow_handle.id,
+                )
+            ),
+        )
+        return workflow_handle
+
+    return _start()

biased-0.1.2.dev13/pyproject.toml

@@ -1,40 +0,0 @@
-[project]
-name = "biased"
-version = "0.1.2.dev13"
-description = "Various reusable components, helpers, and utilities which I would like to use in any Python project"
-readme = "README.md"
-authors = [
-    { name = "Dmitry Tatarkin", email = "tatarkin@gmail.com" }
-]
-requires-python = ">=3.12"
-dependencies = [
-    "injector>=0.22.0",
-    "pydantic>=2",
-    "python-dateutil>=2.9.0.post0",
-    "structlog>=25.4.0",
-    "ulid-py>=1.1.0",
-]
-
-[project.optional-dependencies]
-django = [
-    "django>=5.2.6",
-]
-ninja = [
-    "django-ninja>=1.4.3",
-]
-django-redis = [
-    "django-redis>=6.0.0",
-]
-django-jsonform = [
-    "django-jsonform>=2.23.2",
-]
-
-[build-system]
-requires = ["uv_build>=0.8.16,<0.9.0"]
-build-backend = "uv_build"
-
-[dependency-groups]
-dev = [
-    "pytest>=9.0.2",
-    "rust-just>=1.43.0",
-]