skillforge-client 0.3.0__py3-none-any.whl

skillforge_client/models/job_page.py

@@ -0,0 +1,100 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+if TYPE_CHECKING:
+    from ..models.job_list_item import JobListItem
+
+
+T = TypeVar("T", bound="JobPage")
+
+
+@_attrs_define
+class JobPage:
+    """A page of jobs plus the total match count, for offset pagination.
+
+    Attributes:
+        items (list[JobListItem]):
+        limit (int):
+        offset (int):
+        total (int):
+    """
+
+    items: list[JobListItem]
+    limit: int
+    offset: int
+    total: int
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        items = []
+        for items_item_data in self.items:
+            items_item = items_item_data.to_dict()
+            items.append(items_item)
+
+        limit = self.limit
+
+        offset = self.offset
+
+        total = self.total
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "items": items,
+                "limit": limit,
+                "offset": offset,
+                "total": total,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.job_list_item import JobListItem
+
+        d = dict(src_dict)
+        items = []
+        _items = d.pop("items")
+        for items_item_data in _items:
+            items_item = JobListItem.from_dict(items_item_data)
+
+            items.append(items_item)
+
+        limit = d.pop("limit")
+
+        offset = d.pop("offset")
+
+        total = d.pop("total")
+
+        job_page = cls(
+            items=items,
+            limit=limit,
+            offset=offset,
+            total=total,
+        )
+
+        job_page.additional_properties = d
+        return job_page
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

skillforge_client/models/job_queue_summary.py

@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+if TYPE_CHECKING:
+    from ..models.job_kind_counts import JobKindCounts
+    from ..models.job_status_counts import JobStatusCounts
+
+
+T = TypeVar("T", bound="JobQueueSummary")
+
+
+@_attrs_define
+class JobQueueSummary:
+    """Queue funnel: global depth (``total``/``open``) and status counts, plus a per-kind breakdown.
+
+    ``open`` is outstanding work -- ``pending`` (including jobs delayed by retry backoff) plus
+    ``claimed``. Terminal counts are historical totals (rows are retained). ``by_kind`` is sorted by
+    kind and scoped to whatever ``kind`` filter the summary was fetched with.
+
+        Attributes:
+            by_kind (list[JobKindCounts]):
+            open_ (int):
+            statuses (JobStatusCounts): Job counts for every status in the queue funnel, zero-filled (no silent gaps).
+            total (int):
+    """
+
+    by_kind: list[JobKindCounts]
+    open_: int
+    statuses: JobStatusCounts
+    total: int
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        by_kind = []
+        for by_kind_item_data in self.by_kind:
+            by_kind_item = by_kind_item_data.to_dict()
+            by_kind.append(by_kind_item)
+
+        open_ = self.open_
+
+        statuses = self.statuses.to_dict()
+
+        total = self.total
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "by_kind": by_kind,
+                "open": open_,
+                "statuses": statuses,
+                "total": total,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.job_kind_counts import JobKindCounts
+        from ..models.job_status_counts import JobStatusCounts
+
+        d = dict(src_dict)
+        by_kind = []
+        _by_kind = d.pop("by_kind")
+        for by_kind_item_data in _by_kind:
+            by_kind_item = JobKindCounts.from_dict(by_kind_item_data)
+
+            by_kind.append(by_kind_item)
+
+        open_ = d.pop("open")
+
+        statuses = JobStatusCounts.from_dict(d.pop("statuses"))
+
+        total = d.pop("total")
+
+        job_queue_summary = cls(
+            by_kind=by_kind,
+            open_=open_,
+            statuses=statuses,
+            total=total,
+        )
+
+        job_queue_summary.additional_properties = d
+        return job_queue_summary
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

skillforge_client/models/job_response.py

@@ -0,0 +1,187 @@
+from __future__ import annotations
+
+import datetime
+from collections.abc import Mapping
+from typing import Any, TypeVar, cast
+from uuid import UUID
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.job_status import JobStatus
+
+T = TypeVar("T", bound="JobResponse")
+
+
+@_attrs_define
+class JobResponse:
+    """State view returned after completing or failing a job.
+
+    Attributes:
+        attempt (int):
+        available_at (datetime.datetime):
+        claimed_at (datetime.datetime | None):
+        completed_at (datetime.datetime | None):
+        failed_at (datetime.datetime | None):
+        job_id (UUID):
+        kind (str):
+        last_error (None | str):
+        status (JobStatus):
+    """
+
+    attempt: int
+    available_at: datetime.datetime
+    claimed_at: datetime.datetime | None
+    completed_at: datetime.datetime | None
+    failed_at: datetime.datetime | None
+    job_id: UUID
+    kind: str
+    last_error: None | str
+    status: JobStatus
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        attempt = self.attempt
+
+        available_at = self.available_at.isoformat()
+
+        claimed_at: None | str
+        if isinstance(self.claimed_at, datetime.datetime):
+            claimed_at = self.claimed_at.isoformat()
+        else:
+            claimed_at = self.claimed_at
+
+        completed_at: None | str
+        if isinstance(self.completed_at, datetime.datetime):
+            completed_at = self.completed_at.isoformat()
+        else:
+            completed_at = self.completed_at
+
+        failed_at: None | str
+        if isinstance(self.failed_at, datetime.datetime):
+            failed_at = self.failed_at.isoformat()
+        else:
+            failed_at = self.failed_at
+
+        job_id = str(self.job_id)
+
+        kind = self.kind
+
+        last_error: None | str
+        last_error = self.last_error
+
+        status = self.status.value
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "attempt": attempt,
+                "available_at": available_at,
+                "claimed_at": claimed_at,
+                "completed_at": completed_at,
+                "failed_at": failed_at,
+                "job_id": job_id,
+                "kind": kind,
+                "last_error": last_error,
+                "status": status,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        attempt = d.pop("attempt")
+
+        available_at = datetime.datetime.fromisoformat(d.pop("available_at"))
+
+        def _parse_claimed_at(data: object) -> datetime.datetime | None:
+            if data is None:
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                claimed_at_type_0 = datetime.datetime.fromisoformat(data)
+
+                return claimed_at_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(datetime.datetime | None, data)
+
+        claimed_at = _parse_claimed_at(d.pop("claimed_at"))
+
+        def _parse_completed_at(data: object) -> datetime.datetime | None:
+            if data is None:
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                completed_at_type_0 = datetime.datetime.fromisoformat(data)
+
+                return completed_at_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(datetime.datetime | None, data)
+
+        completed_at = _parse_completed_at(d.pop("completed_at"))
+
+        def _parse_failed_at(data: object) -> datetime.datetime | None:
+            if data is None:
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                failed_at_type_0 = datetime.datetime.fromisoformat(data)
+
+                return failed_at_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(datetime.datetime | None, data)
+
+        failed_at = _parse_failed_at(d.pop("failed_at"))
+
+        job_id = UUID(d.pop("job_id"))
+
+        kind = d.pop("kind")
+
+        def _parse_last_error(data: object) -> None | str:
+            if data is None:
+                return data
+            return cast(None | str, data)
+
+        last_error = _parse_last_error(d.pop("last_error"))
+
+        status = JobStatus(d.pop("status"))
+
+        job_response = cls(
+            attempt=attempt,
+            available_at=available_at,
+            claimed_at=claimed_at,
+            completed_at=completed_at,
+            failed_at=failed_at,
+            job_id=job_id,
+            kind=kind,
+            last_error=last_error,
+            status=status,
+        )
+
+        job_response.additional_properties = d
+        return job_response
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

skillforge_client/models/job_status.py

@@ -0,0 +1,11 @@
+from enum import Enum
+
+
+class JobStatus(str, Enum):
+    CLAIMED = "claimed"
+    COMPLETED = "completed"
+    FAILED = "failed"
+    PENDING = "pending"
+
+    def __str__(self) -> str:
+        return str(self.value)

skillforge_client/models/job_status_counts.py

@@ -0,0 +1,86 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+T = TypeVar("T", bound="JobStatusCounts")
+
+
+@_attrs_define
+class JobStatusCounts:
+    """Job counts for every status in the queue funnel, zero-filled (no silent gaps).
+
+    Attributes:
+        claimed (int):
+        completed (int):
+        failed (int):
+        pending (int):
+    """
+
+    claimed: int
+    completed: int
+    failed: int
+    pending: int
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        claimed = self.claimed
+
+        completed = self.completed
+
+        failed = self.failed
+
+        pending = self.pending
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "claimed": claimed,
+                "completed": completed,
+                "failed": failed,
+                "pending": pending,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        claimed = d.pop("claimed")
+
+        completed = d.pop("completed")
+
+        failed = d.pop("failed")
+
+        pending = d.pop("pending")
+
+        job_status_counts = cls(
+            claimed=claimed,
+            completed=completed,
+            failed=failed,
+            pending=pending,
+        )
+
+        job_status_counts.additional_properties = d
+        return job_status_counts
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

skillforge_client/models/member_role.py

@@ -0,0 +1,10 @@
+from enum import Enum
+
+
+class MemberRole(str, Enum):
+    ADMIN = "admin"
+    STUDENT = "student"
+    TUTOR = "tutor"
+
+    def __str__(self) -> str:
+        return str(self.value)

skillforge_client/models/microsoft_account_profile.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+T = TypeVar("T", bound="MicrosoftAccountProfile")
+
+
+@_attrs_define
+class MicrosoftAccountProfile:
+    """
+    Attributes:
+        user_id (str):
+    """
+
+    user_id: str
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        user_id = self.user_id
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "user_id": user_id,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        user_id = d.pop("user_id")
+
+        microsoft_account_profile = cls(
+            user_id=user_id,
+        )
+
+        microsoft_account_profile.additional_properties = d
+        return microsoft_account_profile
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

skillforge_client/models/operation_cancel_response.py

@@ -0,0 +1,108 @@
+from __future__ import annotations
+
+import datetime
+from collections.abc import Mapping
+from typing import Any, TypeVar, cast
+from uuid import UUID
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.operation_kind import OperationKind
+from ..models.operation_status import OperationStatus
+
+T = TypeVar("T", bound="OperationCancelResponse")
+
+
+@_attrs_define
+class OperationCancelResponse:
+    """
+    Attributes:
+        cancelled_at (datetime.datetime | None):
+        kind (OperationKind):
+        operation_id (UUID):
+        status (OperationStatus):
+    """
+
+    cancelled_at: datetime.datetime | None
+    kind: OperationKind
+    operation_id: UUID
+    status: OperationStatus
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        cancelled_at: None | str
+        if isinstance(self.cancelled_at, datetime.datetime):
+            cancelled_at = self.cancelled_at.isoformat()
+        else:
+            cancelled_at = self.cancelled_at
+
+        kind = self.kind.value
+
+        operation_id = str(self.operation_id)
+
+        status = self.status.value
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "cancelled_at": cancelled_at,
+                "kind": kind,
+                "operation_id": operation_id,
+                "status": status,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+
+        def _parse_cancelled_at(data: object) -> datetime.datetime | None:
+            if data is None:
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                cancelled_at_type_0 = datetime.datetime.fromisoformat(data)
+
+                return cancelled_at_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(datetime.datetime | None, data)
+
+        cancelled_at = _parse_cancelled_at(d.pop("cancelled_at"))
+
+        kind = OperationKind(d.pop("kind"))
+
+        operation_id = UUID(d.pop("operation_id"))
+
+        status = OperationStatus(d.pop("status"))
+
+        operation_cancel_response = cls(
+            cancelled_at=cancelled_at,
+            kind=kind,
+            operation_id=operation_id,
+            status=status,
+        )
+
+        operation_cancel_response.additional_properties = d
+        return operation_cancel_response
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

skillforge_client/models/operation_kind.py

@@ -0,0 +1,13 @@
+from enum import Enum
+
+
+class OperationKind(str, Enum):
+    STUDENT_ACTIVATE = "student_activate"
+    STUDENT_DEACTIVATE = "student_deactivate"
+    STUDENT_POP = "student_pop"
+    STUDENT_STASH = "student_stash"
+    TUTOR_ACTIVATE = "tutor_activate"
+    TUTOR_DEACTIVATE = "tutor_deactivate"
+
+    def __str__(self) -> str:
+        return str(self.value)