dart-tools 0.8.0__py3-none-any.whl → 0.8.2__py3-none-any.whl

dart/generated/api/task/list_tasks.py

@@ -36,6 +36,8 @@ def _get_kwargs(
     title: Union[Unset, str] = UNSET,
     type_: Union[Unset, str] = UNSET,
     type_id: Union[Unset, str] = UNSET,
+    view: Union[Unset, str] = UNSET,
+    view_id: Union[Unset, str] = UNSET,
 ) -> dict[str, Any]:
     params: dict[str, Any] = {}
 
@@ -99,6 +101,10 @@ def _get_kwargs(
 
     params["type_id"] = type_id
 
+    params["view"] = view
+
+    params["view_id"] = view_id
+
     params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
 
     _kwargs: dict[str, Any] = {
@@ -161,9 +167,11 @@ def sync_detailed(
     title: Union[Unset, str] = UNSET,
     type_: Union[Unset, str] = UNSET,
     type_id: Union[Unset, str] = UNSET,
+    view: Union[Unset, str] = UNSET,
+    view_id: Union[Unset, str] = UNSET,
 ) -> Response[PaginatedConciseTaskList]:
-    """List all tasks that the user has access to. This will return a list of tasks, including the title,
-    dartboard, status, description and others.
+    """List tasks with powerful filtering options. Filter by dartboard, status, assignee, tags, priority,
+    dates, completion state, view, and more. Supports pagination with limit/offset.
 
     Args:
         assignee (Union[Unset, str]):
@@ -190,6 +198,8 @@ def sync_detailed(
         title (Union[Unset, str]):
         type_ (Union[Unset, str]):
         type_id (Union[Unset, str]):
+        view (Union[Unset, str]):
+        view_id (Union[Unset, str]):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -224,6 +234,8 @@ def sync_detailed(
         title=title,
         type_=type_,
         type_id=type_id,
+        view=view,
+        view_id=view_id,
     )
 
     response = client.get_httpx_client().request(
@@ -260,9 +272,11 @@ def sync(
     title: Union[Unset, str] = UNSET,
     type_: Union[Unset, str] = UNSET,
     type_id: Union[Unset, str] = UNSET,
+    view: Union[Unset, str] = UNSET,
+    view_id: Union[Unset, str] = UNSET,
 ) -> Optional[PaginatedConciseTaskList]:
-    """List all tasks that the user has access to. This will return a list of tasks, including the title,
-    dartboard, status, description and others.
+    """List tasks with powerful filtering options. Filter by dartboard, status, assignee, tags, priority,
+    dates, completion state, view, and more. Supports pagination with limit/offset.
 
     Args:
         assignee (Union[Unset, str]):
@@ -289,6 +303,8 @@ def sync(
         title (Union[Unset, str]):
         type_ (Union[Unset, str]):
         type_id (Union[Unset, str]):
+        view (Union[Unset, str]):
+        view_id (Union[Unset, str]):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -324,6 +340,8 @@ def sync(
         title=title,
         type_=type_,
         type_id=type_id,
+        view=view,
+        view_id=view_id,
     ).parsed
 
 
@@ -354,9 +372,11 @@ async def asyncio_detailed(
     title: Union[Unset, str] = UNSET,
     type_: Union[Unset, str] = UNSET,
     type_id: Union[Unset, str] = UNSET,
+    view: Union[Unset, str] = UNSET,
+    view_id: Union[Unset, str] = UNSET,
 ) -> Response[PaginatedConciseTaskList]:
-    """List all tasks that the user has access to. This will return a list of tasks, including the title,
-    dartboard, status, description and others.
+    """List tasks with powerful filtering options. Filter by dartboard, status, assignee, tags, priority,
+    dates, completion state, view, and more. Supports pagination with limit/offset.
 
     Args:
         assignee (Union[Unset, str]):
@@ -383,6 +403,8 @@ async def asyncio_detailed(
         title (Union[Unset, str]):
         type_ (Union[Unset, str]):
         type_id (Union[Unset, str]):
+        view (Union[Unset, str]):
+        view_id (Union[Unset, str]):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -417,6 +439,8 @@ async def asyncio_detailed(
         title=title,
         type_=type_,
         type_id=type_id,
+        view=view,
+        view_id=view_id,
     )
 
     response = await client.get_async_httpx_client().request(**kwargs)
@@ -451,9 +475,11 @@ async def asyncio(
     title: Union[Unset, str] = UNSET,
     type_: Union[Unset, str] = UNSET,
     type_id: Union[Unset, str] = UNSET,
+    view: Union[Unset, str] = UNSET,
+    view_id: Union[Unset, str] = UNSET,
 ) -> Optional[PaginatedConciseTaskList]:
-    """List all tasks that the user has access to. This will return a list of tasks, including the title,
-    dartboard, status, description and others.
+    """List tasks with powerful filtering options. Filter by dartboard, status, assignee, tags, priority,
+    dates, completion state, view, and more. Supports pagination with limit/offset.
 
     Args:
         assignee (Union[Unset, str]):
@@ -480,6 +506,8 @@ async def asyncio(
         title (Union[Unset, str]):
         type_ (Union[Unset, str]):
         type_id (Union[Unset, str]):
+        view (Union[Unset, str]):
+        view_id (Union[Unset, str]):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -516,5 +544,7 @@ async def asyncio(
             title=title,
             type_=type_,
             type_id=type_id,
+            view=view,
+            view_id=view_id,
         )
     ).parsed

dart/generated/api/view/retrieve_view.py

@@ -60,7 +60,7 @@ def sync_detailed(
     """Retrieve an existing view
 
      Retrieve an existing view. This will return the view's information, including the title,
-    description, all tasks within it, and others.
+    description, and others.
 
     Args:
         id (str):
@@ -92,7 +92,7 @@ def sync(
     """Retrieve an existing view
 
      Retrieve an existing view. This will return the view's information, including the title,
-    description, all tasks within it, and others.
+    description, and others.
 
     Args:
         id (str):
@@ -119,7 +119,7 @@ async def asyncio_detailed(
     """Retrieve an existing view
 
      Retrieve an existing view. This will return the view's information, including the title,
-    description, all tasks within it, and others.
+    description, and others.
 
     Args:
         id (str):
@@ -149,7 +149,7 @@ async def asyncio(
     """Retrieve an existing view
 
      Retrieve an existing view. This will return the view's information, including the title,
-    description, all tasks within it, and others.
+    description, and others.
 
     Args:
         id (str):

dart/generated/models/__init__.py

@@ -16,9 +16,10 @@ from .paginated_comment_list import PaginatedCommentList
 from .paginated_concise_doc_list import PaginatedConciseDocList
 from .paginated_concise_task_list import PaginatedConciseTaskList
 from .priority import Priority
+from .skill import Skill
 from .task import Task
 from .task_create import TaskCreate
-from .task_relationships import TaskRelationships
+from .task_relationships_type_0 import TaskRelationshipsType0
 from .task_update import TaskUpdate
 from .time_tracking_entry import TimeTrackingEntry
 from .user import User
@@ -61,6 +62,8 @@ from .wrapped_doc import WrappedDoc
 from .wrapped_doc_create import WrappedDocCreate
 from .wrapped_doc_update import WrappedDocUpdate
 from .wrapped_folder import WrappedFolder
+from .wrapped_help_center_articles import WrappedHelpCenterArticles
+from .wrapped_skill import WrappedSkill
 from .wrapped_task import WrappedTask
 from .wrapped_task_create import WrappedTaskCreate
 from .wrapped_task_update import WrappedTaskUpdate
@@ -83,9 +86,10 @@ __all__ = (
     "PaginatedConciseDocList",
     "PaginatedConciseTaskList",
     "Priority",
+    "Skill",
     "Task",
     "TaskCreate",
-    "TaskRelationships",
+    "TaskRelationshipsType0",
     "TaskUpdate",
     "TimeTrackingEntry",
     "User",
@@ -108,6 +112,8 @@ __all__ = (
     "WrappedDocCreate",
     "WrappedDocUpdate",
     "WrappedFolder",
+    "WrappedHelpCenterArticles",
+    "WrappedSkill",
     "WrappedTask",
     "WrappedTaskCreate",
     "WrappedTaskUpdate",

dart/generated/models/concise_task.py

@@ -22,7 +22,9 @@ class ConciseTask:
         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.
+        parent_id (Union[None, str]): The universal, unique ID of the parent task. This can be null. These tasks have a
+            parent-child relationship where the current task is the child and this task ID corresponds to the parent.
+            Subtasks inherit context from their parent and are typically smaller units of work.
         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.

dart/generated/models/dartboard.py

@@ -1,13 +1,9 @@
 from collections.abc import Mapping
-from typing import TYPE_CHECKING, Any, TypeVar
+from typing import Any, TypeVar
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 
-if TYPE_CHECKING:
-    from ..models.task import Task
-
-
 T = TypeVar("T", bound="Dartboard")
 
 
@@ -19,14 +15,12 @@ class 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.
     """
 
     id: str
     html_url: str
     title: str
     description: str
-    tasks: list["Task"]
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
@@ -38,11 +32,6 @@ class Dartboard:
 
         description = self.description
 
-        tasks = []
-        for tasks_item_data in self.tasks:
-            tasks_item = tasks_item_data.to_dict()
-            tasks.append(tasks_item)
-
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
@@ -51,7 +40,6 @@ class Dartboard:
                 "htmlUrl": html_url,
                 "title": title,
                 "description": description,
-                "tasks": tasks,
             }
         )
 
@@ -59,8 +47,6 @@ class Dartboard:
 
     @classmethod
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
-        from ..models.task import Task
-
         d = dict(src_dict)
         id = d.pop("id")
 
@@ -70,19 +56,11 @@ class Dartboard:
 
         description = d.pop("description")
 
-        tasks = []
-        _tasks = d.pop("tasks")
-        for tasks_item_data in _tasks:
-            tasks_item = Task.from_dict(tasks_item_data)
-
-            tasks.append(tasks_item)
-
         dartboard = cls(
             id=id,
             html_url=html_url,
             title=title,
             description=description,
-            tasks=tasks,
         )
 
         dartboard.additional_properties = d

dart/generated/models/folder.py

@@ -1,13 +1,9 @@
 from collections.abc import Mapping
-from typing import TYPE_CHECKING, Any, TypeVar
+from typing import Any, TypeVar
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 
-if TYPE_CHECKING:
-    from ..models.doc import Doc
-
-
 T = TypeVar("T", bound="Folder")
 
 
@@ -19,14 +15,12 @@ class Folder:
         html_url (str): The URL that can be used to open the folder in the Dart web UI.
         title (str): The title, which is a short description of the folder.
         description (str): The description, which is a longer description of the folder.
-        docs (list['Doc']): The list of all of the docs in the folder.
     """
 
     id: str
     html_url: str
     title: str
     description: str
-    docs: list["Doc"]
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
@@ -38,11 +32,6 @@ class Folder:
 
         description = self.description
 
-        docs = []
-        for docs_item_data in self.docs:
-            docs_item = docs_item_data.to_dict()
-            docs.append(docs_item)
-
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
@@ -51,7 +40,6 @@ class Folder:
                 "htmlUrl": html_url,
                 "title": title,
                 "description": description,
-                "docs": docs,
             }
         )
 
@@ -59,8 +47,6 @@ class Folder:
 
     @classmethod
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
-        from ..models.doc import Doc
-
         d = dict(src_dict)
         id = d.pop("id")
 
@@ -70,19 +56,11 @@ class Folder:
 
         description = d.pop("description")
 
-        docs = []
-        _docs = d.pop("docs")
-        for docs_item_data in _docs:
-            docs_item = Doc.from_dict(docs_item_data)
-
-            docs.append(docs_item)
-
         folder = cls(
             id=id,
             html_url=html_url,
             title=title,
             description=description,
-            docs=docs,
         )
 
         folder.additional_properties = d

dart/generated/models/skill.py

@@ -0,0 +1,75 @@
+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="Skill")
+
+
+@_attrs_define
+class Skill:
+    """
+    Attributes:
+        id (str): The universal, unique ID of the skill.
+        title (str): The title of the skill, describing the task type.
+        prompt_markdown (str): User-defined instructions for performing this skill in markdown format.
+    """
+
+    id: str
+    title: str
+    prompt_markdown: str
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        id = self.id
+
+        title = self.title
+
+        prompt_markdown = self.prompt_markdown
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "id": id,
+                "title": title,
+                "promptMarkdown": prompt_markdown,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        id = d.pop("id")
+
+        title = d.pop("title")
+
+        prompt_markdown = d.pop("promptMarkdown")
+
+        skill = cls(
+            id=id,
+            title=title,
+            prompt_markdown=prompt_markdown,
+        )
+
+        skill.additional_properties = d
+        return skill
+
+    @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/task.py

@@ -9,7 +9,7 @@ from ..types import UNSET, Unset
 
 if TYPE_CHECKING:
     from ..models.custom_properties import CustomProperties
-    from ..models.task_relationships import TaskRelationships
+    from ..models.task_relationships_type_0 import TaskRelationshipsType0
 
 
 T = TypeVar("T", bound="Task")
@@ -22,7 +22,9 @@ class Task:
         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.
+        parent_id (Union[None, str]): The universal, unique ID of the parent task. This can be null. These tasks have a
+            parent-child relationship where the current task is the child and this task ID corresponds to the parent.
+            Subtasks inherit context from their parent and are typically smaller units of work.
         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.
@@ -46,7 +48,7 @@ class Task:
             on the task in hh:mm:ss format (or an empty string if no time has been tracked).
         custom_properties (Union['CustomProperties', None, Unset]): The custom properties, which is a dict of custom
             properties that are associated with the task.
-        task_relationships (Union['TaskRelationships', None, Unset]): The relationships associated with the task.
+        task_relationships (Union['TaskRelationshipsType0', None, Unset]): The relationships associated with the task.
     """
 
     id: str
@@ -66,12 +68,12 @@ class Task:
     size: Union[None, Unset, int, str] = UNSET
     time_tracking: Union[Unset, str] = UNSET
     custom_properties: Union["CustomProperties", None, Unset] = UNSET
-    task_relationships: Union["TaskRelationships", None, Unset] = UNSET
+    task_relationships: Union["TaskRelationshipsType0", None, Unset] = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
         from ..models.custom_properties import CustomProperties
-        from ..models.task_relationships import TaskRelationships
+        from ..models.task_relationships_type_0 import TaskRelationshipsType0
 
         id = self.id
 
@@ -148,7 +150,7 @@ class Task:
         task_relationships: Union[None, Unset, dict[str, Any]]
         if isinstance(self.task_relationships, Unset):
             task_relationships = UNSET
-        elif isinstance(self.task_relationships, TaskRelationships):
+        elif isinstance(self.task_relationships, TaskRelationshipsType0):
             task_relationships = self.task_relationships.to_dict()
         else:
             task_relationships = self.task_relationships
@@ -193,7 +195,7 @@ class Task:
     @classmethod
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
         from ..models.custom_properties import CustomProperties
-        from ..models.task_relationships import TaskRelationships
+        from ..models.task_relationships_type_0 import TaskRelationshipsType0
 
         d = dict(src_dict)
         id = d.pop("id")
@@ -312,7 +314,7 @@ class Task:
 
         def _parse_task_relationships(
             data: object,
-        ) -> Union["TaskRelationships", None, Unset]:
+        ) -> Union["TaskRelationshipsType0", None, Unset]:
             if data is None:
                 return data
             if isinstance(data, Unset):
@@ -320,12 +322,12 @@ class Task:
             try:
                 if not isinstance(data, dict):
                     raise TypeError()
-                task_relationships_type_0 = TaskRelationships.from_dict(data)
+                componentsschemas_task_relationships_type_0 = TaskRelationshipsType0.from_dict(data)
 
-                return task_relationships_type_0
+                return componentsschemas_task_relationships_type_0
             except:  # noqa: E722
                 pass
-            return cast(Union["TaskRelationships", None, Unset], data)
+            return cast(Union["TaskRelationshipsType0", None, Unset], data)
 
         task_relationships = _parse_task_relationships(d.pop("taskRelationships", UNSET))
 

dart/generated/models/task_create.py

@@ -9,7 +9,7 @@ from ..types import UNSET, Unset
 
 if TYPE_CHECKING:
     from ..models.custom_properties import CustomProperties
-    from ..models.task_relationships import TaskRelationships
+    from ..models.task_relationships_type_0 import TaskRelationshipsType0
 
 
 T = TypeVar("T", bound="TaskCreate")
@@ -20,7 +20,9 @@ class TaskCreate:
     """
     Attributes:
         title (str): The title, which is a short description of what needs to be done.
-        parent_id (Union[None, Unset, str]): The universal, unique ID of the parent task. This can be null.
+        parent_id (Union[None, Unset, str]): The universal, unique ID of the parent task. This can be null. These tasks
+            have a parent-child relationship where the current task is the child and this task ID corresponds to the parent.
+            Subtasks inherit context from their parent and are typically smaller units of work.
         dartboard (Union[Unset, str]): The full title of the dartboard, which is a project or list of tasks.
         type_ (Union[Unset, str]): The title of the type of the task.
         status (Union[Unset, str]): The status from the list of available statuses.
@@ -42,7 +44,7 @@ class TaskCreate:
             is used to determine how long the task will take to complete.
         custom_properties (Union['CustomProperties', None, Unset]): The custom properties, which is a dict of custom
             properties that are associated with the task.
-        task_relationships (Union['TaskRelationships', None, Unset]): The relationships associated with the task.
+        task_relationships (Union['TaskRelationshipsType0', None, Unset]): The relationships associated with the task.
     """
 
     title: str
@@ -59,12 +61,12 @@ class TaskCreate:
     due_at: Union[None, Unset, str] = UNSET
     size: Union[None, Unset, int, str] = UNSET
     custom_properties: Union["CustomProperties", None, Unset] = UNSET
-    task_relationships: Union["TaskRelationships", None, Unset] = UNSET
+    task_relationships: Union["TaskRelationshipsType0", None, Unset] = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
         from ..models.custom_properties import CustomProperties
-        from ..models.task_relationships import TaskRelationships
+        from ..models.task_relationships_type_0 import TaskRelationshipsType0
 
         title = self.title
 
@@ -138,7 +140,7 @@ class TaskCreate:
         task_relationships: Union[None, Unset, dict[str, Any]]
         if isinstance(self.task_relationships, Unset):
             task_relationships = UNSET
-        elif isinstance(self.task_relationships, TaskRelationships):
+        elif isinstance(self.task_relationships, TaskRelationshipsType0):
             task_relationships = self.task_relationships.to_dict()
         else:
             task_relationships = self.task_relationships
@@ -184,7 +186,7 @@ class TaskCreate:
     @classmethod
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
         from ..models.custom_properties import CustomProperties
-        from ..models.task_relationships import TaskRelationships
+        from ..models.task_relationships_type_0 import TaskRelationshipsType0
 
         d = dict(src_dict)
         title = d.pop("title")
@@ -299,7 +301,7 @@ class TaskCreate:
 
         def _parse_task_relationships(
             data: object,
-        ) -> Union["TaskRelationships", None, Unset]:
+        ) -> Union["TaskRelationshipsType0", None, Unset]:
             if data is None:
                 return data
             if isinstance(data, Unset):
@@ -307,12 +309,12 @@ class TaskCreate:
             try:
                 if not isinstance(data, dict):
                     raise TypeError()
-                task_relationships_type_0 = TaskRelationships.from_dict(data)
+                componentsschemas_task_relationships_type_0 = TaskRelationshipsType0.from_dict(data)
 
-                return task_relationships_type_0
+                return componentsschemas_task_relationships_type_0
             except:  # noqa: E722
                 pass
-            return cast(Union["TaskRelationships", None, Unset], data)
+            return cast(Union["TaskRelationshipsType0", None, Unset], data)
 
         task_relationships = _parse_task_relationships(d.pop("taskRelationships", UNSET))