dart-tools 0.6.16__py3-none-any.whl → 0.7.0__py3-none-any.whl

dart/generated/models/concise_task.py

@@ -0,0 +1,267 @@
+from collections.abc import Mapping
+from typing import Any, TypeVar, Union, cast
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.priority import Priority
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="ConciseTask")
+
+
+@_attrs_define
+class ConciseTask:
+    """This concise task serializer is going to be used in tasks listing view only.
+
+    Attributes:
+        id (str): The universal, unique ID of the task.
+        html_url (str): The URL that can be used to open the task in the Dart web UI.
+        title (str): The title, which is a short description of what needs to be done.
+        parent_id (Union[None, str]): The universal, unique ID of the parent task. This can be null.
+        dartboard (str): The full title of the dartboard, which is a project or list of tasks.
+        type_ (str): The title of the type of the task.
+        status (str): The status from the list of available statuses.
+        assignees (Union[Unset, list[str]]): The names or emails of the users that the task is assigned to. Either this
+            or assignee must be included, depending on whether the workspaces allows multiple assignees or not.
+        assignee (Union[None, Unset, str]): The name or email of the user that the task is assigned to. Either this or
+            assignees must be included, depending on whether the workspaces allows multiple assignees or not.
+        tags (Union[Unset, list[str]]): Any tags that should be applied to the task, which can be used to filter and
+            search for tasks. Tags are also known as labels or components and are strings that can be anything, but should
+            be short and descriptive. This list can be empty.
+        priority (Union[None, Priority, Unset]): The priority, which is a string that can be one of the specified
+            options. This is used to sort tasks and determine which tasks should be done first.
+        start_at (Union[None, Unset, str]): The start date, which is a date and time that the task should be started by
+            in ISO format. It should be at 9:00am in the timezone of the user.
+        due_at (Union[None, Unset, str]): The due date, which is a date and time that the task should be completed by in
+            ISO format. It should be at 9:00am in the timezone of the user.
+        size (Union[None, Unset, int]): The size, which is a number that represents the amount of work that needs to be
+            done. This is used to determine how long the task will take to complete.
+        time_tracking (Union[Unset, str]): The time tracking, which is a string that indicates the amount of time spent
+            on the task in hh:mm:ss format (or an empty string if no time has been tracked).
+    """
+
+    id: str
+    html_url: str
+    title: str
+    parent_id: Union[None, str]
+    dartboard: str
+    type_: str
+    status: str
+    assignees: Union[Unset, list[str]] = UNSET
+    assignee: Union[None, Unset, str] = UNSET
+    tags: Union[Unset, list[str]] = UNSET
+    priority: Union[None, Priority, Unset] = UNSET
+    start_at: Union[None, Unset, str] = UNSET
+    due_at: Union[None, Unset, str] = UNSET
+    size: Union[None, Unset, int] = UNSET
+    time_tracking: Union[Unset, str] = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        id = self.id
+
+        html_url = self.html_url
+
+        title = self.title
+
+        parent_id: Union[None, str]
+        parent_id = self.parent_id
+
+        dartboard = self.dartboard
+
+        type_ = self.type_
+
+        status = self.status
+
+        assignees: Union[Unset, list[str]] = UNSET
+        if not isinstance(self.assignees, Unset):
+            assignees = self.assignees
+
+        assignee: Union[None, Unset, str]
+        if isinstance(self.assignee, Unset):
+            assignee = UNSET
+        else:
+            assignee = self.assignee
+
+        tags: Union[Unset, list[str]] = UNSET
+        if not isinstance(self.tags, Unset):
+            tags = self.tags
+
+        priority: Union[None, Unset, str]
+        if isinstance(self.priority, Unset):
+            priority = UNSET
+        elif isinstance(self.priority, Priority):
+            priority = self.priority.value
+        else:
+            priority = self.priority
+
+        start_at: Union[None, Unset, str]
+        if isinstance(self.start_at, Unset):
+            start_at = UNSET
+        else:
+            start_at = self.start_at
+
+        due_at: Union[None, Unset, str]
+        if isinstance(self.due_at, Unset):
+            due_at = UNSET
+        else:
+            due_at = self.due_at
+
+        size: Union[None, Unset, int]
+        if isinstance(self.size, Unset):
+            size = UNSET
+        else:
+            size = self.size
+
+        time_tracking = self.time_tracking
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "id": id,
+                "htmlUrl": html_url,
+                "title": title,
+                "parentId": parent_id,
+                "dartboard": dartboard,
+                "type": type_,
+                "status": status,
+            }
+        )
+        if assignees is not UNSET:
+            field_dict["assignees"] = assignees
+        if assignee is not UNSET:
+            field_dict["assignee"] = assignee
+        if tags is not UNSET:
+            field_dict["tags"] = tags
+        if priority is not UNSET:
+            field_dict["priority"] = priority
+        if start_at is not UNSET:
+            field_dict["startAt"] = start_at
+        if due_at is not UNSET:
+            field_dict["dueAt"] = due_at
+        if size is not UNSET:
+            field_dict["size"] = size
+        if time_tracking is not UNSET:
+            field_dict["timeTracking"] = time_tracking
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        id = d.pop("id")
+
+        html_url = d.pop("htmlUrl")
+
+        title = d.pop("title")
+
+        def _parse_parent_id(data: object) -> Union[None, str]:
+            if data is None:
+                return data
+            return cast(Union[None, str], data)
+
+        parent_id = _parse_parent_id(d.pop("parentId"))
+
+        dartboard = d.pop("dartboard")
+
+        type_ = d.pop("type")
+
+        status = d.pop("status")
+
+        assignees = cast(list[str], d.pop("assignees", UNSET))
+
+        def _parse_assignee(data: object) -> Union[None, Unset, str]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(Union[None, Unset, str], data)
+
+        assignee = _parse_assignee(d.pop("assignee", UNSET))
+
+        tags = cast(list[str], d.pop("tags", UNSET))
+
+        def _parse_priority(data: object) -> Union[None, Priority, Unset]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                priority_type_0 = Priority(data)
+
+                return priority_type_0
+            except:  # noqa: E722
+                pass
+            return cast(Union[None, Priority, Unset], data)
+
+        priority = _parse_priority(d.pop("priority", UNSET))
+
+        def _parse_start_at(data: object) -> Union[None, Unset, str]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(Union[None, Unset, str], data)
+
+        start_at = _parse_start_at(d.pop("startAt", UNSET))
+
+        def _parse_due_at(data: object) -> Union[None, Unset, str]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(Union[None, Unset, str], data)
+
+        due_at = _parse_due_at(d.pop("dueAt", UNSET))
+
+        def _parse_size(data: object) -> Union[None, Unset, int]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(Union[None, Unset, int], data)
+
+        size = _parse_size(d.pop("size", UNSET))
+
+        time_tracking = d.pop("timeTracking", UNSET)
+
+        concise_task = cls(
+            id=id,
+            html_url=html_url,
+            title=title,
+            parent_id=parent_id,
+            dartboard=dartboard,
+            type_=type_,
+            status=status,
+            assignees=assignees,
+            assignee=assignee,
+            tags=tags,
+            priority=priority,
+            start_at=start_at,
+            due_at=due_at,
+            size=size,
+            time_tracking=time_tracking,
+        )
+
+        concise_task.additional_properties = d
+        return concise_task
+
+    @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

dart/generated/models/dartboard.py

@@ -1,16 +1,11 @@
-import datetime
-from typing import TYPE_CHECKING, Any, Dict, List, Type, TypeVar, Union, cast
+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
-from dateutil.parser import isoparse
-
-from ..models.dartboard_kind import DartboardKind
-from ..models.icon_kind import IconKind
-from ..types import UNSET, Unset
 
 if TYPE_CHECKING:
-    from ..models.user_dartboard_layout import UserDartboardLayout
+    from ..models.task import Task
 
 
 T = TypeVar("T", bound="Dartboard")
@@ -20,276 +15,81 @@ T = TypeVar("T", bound="Dartboard")
 class Dartboard:
     """
     Attributes:
-        duid (str):
-        space_duid (str):
-        kind (DartboardKind): * `Active` - ACTIVE
-            * `Next` - NEXT
-            * `Backlog` - BACKLOG
-            * `Finished` - FINISHED
-            * `Custom` - CUSTOM
-        order (str):
-        title (str):
-        description (str):
-        icon_kind (IconKind): * `None` - NONE
-            * `Icon` - ICON
-            * `Emoji` - EMOJI
-        icon_name_or_emoji (str):
-        color_hex (str):
-        user_duids_to_layout_duids (List['UserDartboardLayout']):
-        index (Union[None, int]):
-        started_at (Union[None, datetime.datetime]):
-        finished_at (Union[None, datetime.datetime]):
-        planned_finish_at (Union[None, datetime.datetime]):
-        default_property_map (Any):
-        always_shown_property_duids (List[str]):
-        always_hidden_property_duids (List[str]):
-        property_order_duids (List[str]):
-        property_width_map (Any):
-        updated_by_client_duid (Union[None, Unset, str]):
+        id (str): The universal, unique ID of the dartboard.
+        html_url (str): The URL that can be used to open the dartboard in the Dart web UI.
+        title (str): The title, which is a short description of the dartboard.
+        description (str): The description, which is a longer description of the dartboard.
+        tasks (list['Task']): The list of all of the tasks in the dartboard.
     """
 
-    duid: str
-    space_duid: str
-    kind: DartboardKind
-    order: str
+    id: str
+    html_url: str
     title: str
     description: str
-    icon_kind: IconKind
-    icon_name_or_emoji: str
-    color_hex: str
-    user_duids_to_layout_duids: List["UserDartboardLayout"]
-    index: Union[None, int]
-    started_at: Union[None, datetime.datetime]
-    finished_at: Union[None, datetime.datetime]
-    planned_finish_at: Union[None, datetime.datetime]
-    default_property_map: Any
-    always_shown_property_duids: List[str]
-    always_hidden_property_duids: List[str]
-    property_order_duids: List[str]
-    property_width_map: Any
-    updated_by_client_duid: Union[None, Unset, str] = UNSET
-    additional_properties: Dict[str, Any] = _attrs_field(init=False, factory=dict)
-
-    def to_dict(self) -> Dict[str, Any]:
-        duid = self.duid
-
-        space_duid = self.space_duid
+    tasks: list["Task"]
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
-        kind = self.kind.value
+    def to_dict(self) -> dict[str, Any]:
+        id = self.id
 
-        order = self.order
+        html_url = self.html_url
 
         title = self.title
 
         description = self.description
 
-        icon_kind = self.icon_kind.value
-
-        icon_name_or_emoji = self.icon_name_or_emoji
-
-        color_hex = self.color_hex
-
-        user_duids_to_layout_duids = []
-        for user_duids_to_layout_duids_item_data in self.user_duids_to_layout_duids:
-            user_duids_to_layout_duids_item = user_duids_to_layout_duids_item_data.to_dict()
-            user_duids_to_layout_duids.append(user_duids_to_layout_duids_item)
-
-        index: Union[None, int]
-        index = self.index
-
-        started_at: Union[None, str]
-        if isinstance(self.started_at, datetime.datetime):
-            started_at = self.started_at.isoformat()
-        else:
-            started_at = self.started_at
-
-        finished_at: Union[None, str]
-        if isinstance(self.finished_at, datetime.datetime):
-            finished_at = self.finished_at.isoformat()
-        else:
-            finished_at = self.finished_at
-
-        planned_finish_at: Union[None, str]
-        if isinstance(self.planned_finish_at, datetime.datetime):
-            planned_finish_at = self.planned_finish_at.isoformat()
-        else:
-            planned_finish_at = self.planned_finish_at
+        tasks = []
+        for tasks_item_data in self.tasks:
+            tasks_item = tasks_item_data.to_dict()
+            tasks.append(tasks_item)
 
-        default_property_map = self.default_property_map
-
-        always_shown_property_duids = self.always_shown_property_duids
-
-        always_hidden_property_duids = self.always_hidden_property_duids
-
-        property_order_duids = self.property_order_duids
-
-        property_width_map = self.property_width_map
-
-        updated_by_client_duid: Union[None, Unset, str]
-        if isinstance(self.updated_by_client_duid, Unset):
-            updated_by_client_duid = UNSET
-        else:
-            updated_by_client_duid = self.updated_by_client_duid
-
-        field_dict: Dict[str, Any] = {}
+        field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
             {
-                "duid": duid,
-                "spaceDuid": space_duid,
-                "kind": kind,
-                "order": order,
+                "id": id,
+                "htmlUrl": html_url,
                 "title": title,
                 "description": description,
-                "iconKind": icon_kind,
-                "iconNameOrEmoji": icon_name_or_emoji,
-                "colorHex": color_hex,
-                "userDuidsToLayoutDuids": user_duids_to_layout_duids,
-                "index": index,
-                "startedAt": started_at,
-                "finishedAt": finished_at,
-                "plannedFinishAt": planned_finish_at,
-                "defaultPropertyMap": default_property_map,
-                "alwaysShownPropertyDuids": always_shown_property_duids,
-                "alwaysHiddenPropertyDuids": always_hidden_property_duids,
-                "propertyOrderDuids": property_order_duids,
-                "propertyWidthMap": property_width_map,
+                "tasks": tasks,
             }
         )
-        if updated_by_client_duid is not UNSET:
-            field_dict["updatedByClientDuid"] = updated_by_client_duid
 
         return field_dict
 
     @classmethod
-    def from_dict(cls: Type[T], src_dict: Dict[str, Any]) -> T:
-        from ..models.user_dartboard_layout import UserDartboardLayout
-
-        d = src_dict.copy()
-        duid = d.pop("duid")
-
-        space_duid = d.pop("spaceDuid")
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.task import Task
 
-        kind = DartboardKind(d.pop("kind"))
+        d = dict(src_dict)
+        id = d.pop("id")
 
-        order = d.pop("order")
+        html_url = d.pop("htmlUrl")
 
         title = d.pop("title")
 
         description = d.pop("description")
 
-        icon_kind = IconKind(d.pop("iconKind"))
-
-        icon_name_or_emoji = d.pop("iconNameOrEmoji")
-
-        color_hex = d.pop("colorHex")
-
-        user_duids_to_layout_duids = []
-        _user_duids_to_layout_duids = d.pop("userDuidsToLayoutDuids")
-        for user_duids_to_layout_duids_item_data in _user_duids_to_layout_duids:
-            user_duids_to_layout_duids_item = UserDartboardLayout.from_dict(user_duids_to_layout_duids_item_data)
-
-            user_duids_to_layout_duids.append(user_duids_to_layout_duids_item)
-
-        def _parse_index(data: object) -> Union[None, int]:
-            if data is None:
-                return data
-            return cast(Union[None, int], data)
-
-        index = _parse_index(d.pop("index"))
-
-        def _parse_started_at(data: object) -> Union[None, datetime.datetime]:
-            if data is None:
-                return data
-            try:
-                if not isinstance(data, str):
-                    raise TypeError()
-                started_at_type_0 = isoparse(data)
-
-                return started_at_type_0
-            except:  # noqa: E722
-                pass
-            return cast(Union[None, datetime.datetime], data)
-
-        started_at = _parse_started_at(d.pop("startedAt"))
-
-        def _parse_finished_at(data: object) -> Union[None, datetime.datetime]:
-            if data is None:
-                return data
-            try:
-                if not isinstance(data, str):
-                    raise TypeError()
-                finished_at_type_0 = isoparse(data)
-
-                return finished_at_type_0
-            except:  # noqa: E722
-                pass
-            return cast(Union[None, datetime.datetime], data)
-
-        finished_at = _parse_finished_at(d.pop("finishedAt"))
-
-        def _parse_planned_finish_at(data: object) -> Union[None, datetime.datetime]:
-            if data is None:
-                return data
-            try:
-                if not isinstance(data, str):
-                    raise TypeError()
-                planned_finish_at_type_0 = isoparse(data)
-
-                return planned_finish_at_type_0
-            except:  # noqa: E722
-                pass
-            return cast(Union[None, datetime.datetime], data)
-
-        planned_finish_at = _parse_planned_finish_at(d.pop("plannedFinishAt"))
-
-        default_property_map = d.pop("defaultPropertyMap")
-
-        always_shown_property_duids = cast(List[str], d.pop("alwaysShownPropertyDuids"))
-
-        always_hidden_property_duids = cast(List[str], d.pop("alwaysHiddenPropertyDuids"))
-
-        property_order_duids = cast(List[str], d.pop("propertyOrderDuids"))
-
-        property_width_map = d.pop("propertyWidthMap")
-
-        def _parse_updated_by_client_duid(data: object) -> Union[None, Unset, str]:
-            if data is None:
-                return data
-            if isinstance(data, Unset):
-                return data
-            return cast(Union[None, Unset, str], data)
+        tasks = []
+        _tasks = d.pop("tasks")
+        for tasks_item_data in _tasks:
+            tasks_item = Task.from_dict(tasks_item_data)
 
-        updated_by_client_duid = _parse_updated_by_client_duid(d.pop("updatedByClientDuid", UNSET))
+            tasks.append(tasks_item)
 
         dartboard = cls(
-            duid=duid,
-            space_duid=space_duid,
-            kind=kind,
-            order=order,
+            id=id,
+            html_url=html_url,
             title=title,
             description=description,
-            icon_kind=icon_kind,
-            icon_name_or_emoji=icon_name_or_emoji,
-            color_hex=color_hex,
-            user_duids_to_layout_duids=user_duids_to_layout_duids,
-            index=index,
-            started_at=started_at,
-            finished_at=finished_at,
-            planned_finish_at=planned_finish_at,
-            default_property_map=default_property_map,
-            always_shown_property_duids=always_shown_property_duids,
-            always_hidden_property_duids=always_hidden_property_duids,
-            property_order_duids=property_order_duids,
-            property_width_map=property_width_map,
-            updated_by_client_duid=updated_by_client_duid,
+            tasks=tasks,
         )
 
         dartboard.additional_properties = d
         return dartboard
 
     @property
-    def additional_keys(self) -> List[str]:
+    def additional_keys(self) -> list[str]:
         return list(self.additional_properties.keys())
 
     def __getitem__(self, key: str) -> Any: