dart-tools 0.7.2__tar.gz → 0.7.3__tar.gz

{dart_tools-0.7.2 → dart_tools-0.7.3}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Dart
+Copyright (c) 2025 Dart
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{dart_tools-0.7.2/dart_tools.egg-info → dart_tools-0.7.3}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: dart-tools
-Version: 0.7.2
+Version: 0.7.3
 Summary: The Dart CLI and Python Library
 Author-email: Dart <software@itsdart.com>
 License: MIT License
         
-        Copyright (c) 2023 Dart
+        Copyright (c) 2025 Dart
         
         Permission is hereby granted, free of charge, to any person obtaining a copy
         of this software and associated documentation files (the "Software"), to deal
@@ -54,11 +54,11 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: attrs
-Requires-Dist: dateparser
-Requires-Dist: httpx
-Requires-Dist: pick
-Requires-Dist: platformdirs
+Requires-Dist: attrs>=25.3
+Requires-Dist: dateparser>=1.2
+Requires-Dist: httpx>=0.28
+Requires-Dist: pick>=2.4
+Requires-Dist: platformdirs>=4.3
 Dynamic: license-file
 
 <div align="center">

dart_tools-0.7.3/dart/generated/api/__init__.py

@@ -0,0 +1,9 @@
+"""Contains methods for accessing the API"""
+
+from .comment import create_comment
+from .config import get_config
+from .dartboard import retrieve_dartboard
+from .doc import create_doc, delete_doc, list_docs, retrieve_doc, update_doc
+from .folder import retrieve_folder
+from .task import create_task, delete_task, list_tasks, retrieve_task, update_task
+from .view import retrieve_view

{dart_tools-0.7.2 → dart_tools-0.7.3}/dart/generated/api/dartboard/retrieve_dartboard.py

@@ -14,7 +14,9 @@ def _get_kwargs(
 ) -> dict[str, Any]:
     _kwargs: dict[str, Any] = {
         "method": "get",
-        "url": f"/dartboards/{id}",
+        "url": "/dartboards/{id}".format(
+            id=id,
+        ),
     }
 
     return _kwargs

{dart_tools-0.7.2 → dart_tools-0.7.3}/dart/generated/api/doc/delete_doc.py

@@ -14,7 +14,9 @@ def _get_kwargs(
 ) -> dict[str, Any]:
     _kwargs: dict[str, Any] = {
         "method": "delete",
-        "url": f"/docs/{id}",
+        "url": "/docs/{id}".format(
+            id=id,
+        ),
     }
 
     return _kwargs

{dart_tools-0.7.2 → dart_tools-0.7.3}/dart/generated/api/doc/retrieve_doc.py

@@ -14,7 +14,9 @@ def _get_kwargs(
 ) -> dict[str, Any]:
     _kwargs: dict[str, Any] = {
         "method": "get",
-        "url": f"/docs/{id}",
+        "url": "/docs/{id}".format(
+            id=id,
+        ),
     }
 
     return _kwargs

{dart_tools-0.7.2 → dart_tools-0.7.3}/dart/generated/api/doc/update_doc.py

@@ -19,7 +19,9 @@ def _get_kwargs(
 
     _kwargs: dict[str, Any] = {
         "method": "put",
-        "url": f"/docs/{id}",
+        "url": "/docs/{id}".format(
+            id=id,
+        ),
     }
 
     _body = body.to_dict()

{dart_tools-0.7.2 → dart_tools-0.7.3}/dart/generated/api/folder/retrieve_folder.py

@@ -14,7 +14,9 @@ def _get_kwargs(
 ) -> dict[str, Any]:
     _kwargs: dict[str, Any] = {
         "method": "get",
-        "url": f"/folders/{id}",
+        "url": "/folders/{id}".format(
+            id=id,
+        ),
     }
 
     return _kwargs

{dart_tools-0.7.2 → dart_tools-0.7.3}/dart/generated/api/task/delete_task.py

@@ -14,7 +14,9 @@ def _get_kwargs(
 ) -> dict[str, Any]:
     _kwargs: dict[str, Any] = {
         "method": "delete",
-        "url": f"/tasks/{id}",
+        "url": "/tasks/{id}".format(
+            id=id,
+        ),
     }
 
     return _kwargs

{dart_tools-0.7.2 → dart_tools-0.7.3}/dart/generated/api/task/retrieve_task.py

@@ -14,7 +14,9 @@ def _get_kwargs(
 ) -> dict[str, Any]:
     _kwargs: dict[str, Any] = {
         "method": "get",
-        "url": f"/tasks/{id}",
+        "url": "/tasks/{id}".format(
+            id=id,
+        ),
     }
 
     return _kwargs

{dart_tools-0.7.2 → dart_tools-0.7.3}/dart/generated/api/task/update_task.py

@@ -19,7 +19,9 @@ def _get_kwargs(
 
     _kwargs: dict[str, Any] = {
         "method": "put",
-        "url": f"/tasks/{id}",
+        "url": "/tasks/{id}".format(
+            id=id,
+        ),
     }
 
     _body = body.to_dict()

{dart_tools-0.7.2 → dart_tools-0.7.3}/dart/generated/api/view/retrieve_view.py

@@ -14,7 +14,9 @@ def _get_kwargs(
 ) -> dict[str, Any]:
     _kwargs: dict[str, Any] = {
         "method": "get",
-        "url": f"/views/{id}",
+        "url": "/views/{id}".format(
+            id=id,
+        ),
     }
 
     return _kwargs

dart_tools-0.7.3/dart/generated/models/__init__.py

@@ -0,0 +1,107 @@
+"""Contains all the data models used in inputs/outputs"""
+
+from .comment import Comment
+from .comment_create import CommentCreate
+from .concise_doc import ConciseDoc
+from .concise_task import ConciseTask
+from .custom_properties import CustomProperties
+from .dartboard import Dartboard
+from .doc import Doc
+from .doc_create import DocCreate
+from .doc_update import DocUpdate
+from .folder import Folder
+from .list_docs_o_item import ListDocsOItem
+from .paginated_concise_doc_list import PaginatedConciseDocList
+from .paginated_concise_task_list import PaginatedConciseTaskList
+from .priority import Priority
+from .task import Task
+from .task_create import TaskCreate
+from .task_update import TaskUpdate
+from .user import User
+from .user_space_configuration import UserSpaceConfiguration
+from .user_space_configuration_custom_property_checkbox_type_def import (
+    UserSpaceConfigurationCustomPropertyCheckboxTypeDef,
+)
+from .user_space_configuration_custom_property_dates_type_def import (
+    UserSpaceConfigurationCustomPropertyDatesTypeDef,
+)
+from .user_space_configuration_custom_property_multiselect_type_def import (
+    UserSpaceConfigurationCustomPropertyMultiselectTypeDef,
+)
+from .user_space_configuration_custom_property_number_type_def import (
+    UserSpaceConfigurationCustomPropertyNumberTypeDef,
+)
+from .user_space_configuration_custom_property_number_type_def_custom_property_number_format_type_def import (
+    UserSpaceConfigurationCustomPropertyNumberTypeDefCustomPropertyNumberFormatTypeDef,
+)
+from .user_space_configuration_custom_property_select_type_def import (
+    UserSpaceConfigurationCustomPropertySelectTypeDef,
+)
+from .user_space_configuration_custom_property_status_type_def import (
+    UserSpaceConfigurationCustomPropertyStatusTypeDef,
+)
+from .user_space_configuration_custom_property_text_type_def import (
+    UserSpaceConfigurationCustomPropertyTextTypeDef,
+)
+from .user_space_configuration_custom_property_time_tracking_type_def import (
+    UserSpaceConfigurationCustomPropertyTimeTrackingTypeDef,
+)
+from .user_space_configuration_custom_property_user_type_def import (
+    UserSpaceConfigurationCustomPropertyUserTypeDef,
+)
+from .view import View
+from .wrapped_comment import WrappedComment
+from .wrapped_comment_create import WrappedCommentCreate
+from .wrapped_dartboard import WrappedDartboard
+from .wrapped_doc import WrappedDoc
+from .wrapped_doc_create import WrappedDocCreate
+from .wrapped_doc_update import WrappedDocUpdate
+from .wrapped_folder import WrappedFolder
+from .wrapped_task import WrappedTask
+from .wrapped_task_create import WrappedTaskCreate
+from .wrapped_task_update import WrappedTaskUpdate
+from .wrapped_view import WrappedView
+
+__all__ = (
+    "Comment",
+    "CommentCreate",
+    "ConciseDoc",
+    "ConciseTask",
+    "CustomProperties",
+    "Dartboard",
+    "Doc",
+    "DocCreate",
+    "DocUpdate",
+    "Folder",
+    "ListDocsOItem",
+    "PaginatedConciseDocList",
+    "PaginatedConciseTaskList",
+    "Priority",
+    "Task",
+    "TaskCreate",
+    "TaskUpdate",
+    "User",
+    "UserSpaceConfiguration",
+    "UserSpaceConfigurationCustomPropertyCheckboxTypeDef",
+    "UserSpaceConfigurationCustomPropertyDatesTypeDef",
+    "UserSpaceConfigurationCustomPropertyMultiselectTypeDef",
+    "UserSpaceConfigurationCustomPropertyNumberTypeDef",
+    "UserSpaceConfigurationCustomPropertyNumberTypeDefCustomPropertyNumberFormatTypeDef",
+    "UserSpaceConfigurationCustomPropertySelectTypeDef",
+    "UserSpaceConfigurationCustomPropertyStatusTypeDef",
+    "UserSpaceConfigurationCustomPropertyTextTypeDef",
+    "UserSpaceConfigurationCustomPropertyTimeTrackingTypeDef",
+    "UserSpaceConfigurationCustomPropertyUserTypeDef",
+    "View",
+    "WrappedComment",
+    "WrappedCommentCreate",
+    "WrappedDartboard",
+    "WrappedDoc",
+    "WrappedDocCreate",
+    "WrappedDocUpdate",
+    "WrappedFolder",
+    "WrappedTask",
+    "WrappedTaskCreate",
+    "WrappedTaskUpdate",
+    "WrappedView",
+)

{dart_tools-0.7.2 → dart_tools-0.7.3}/dart/generated/models/concise_task.py

@@ -1,5 +1,5 @@
 from collections.abc import Mapping
-from typing import Any, TypeVar, Union, cast
+from typing import TYPE_CHECKING, Any, TypeVar, Union, cast
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
@@ -7,6 +7,10 @@ from attrs import field as _attrs_field
 from ..models.priority import Priority
 from ..types import UNSET, Unset
 
+if TYPE_CHECKING:
+    from ..models.custom_properties import CustomProperties
+
+
 T = TypeVar("T", bound="ConciseTask")
 
 
@@ -22,8 +26,8 @@ class ConciseTask:
         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.
+        assignees (Union[None, 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
@@ -39,6 +43,8 @@ class ConciseTask:
             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).
+        custom_properties (Union['CustomProperties', None, Unset]): The custom properties, which is a dict of custom
+            properties that are associated with the task.
     """
 
     id: str
@@ -48,7 +54,7 @@ class ConciseTask:
     dartboard: str
     type_: str
     status: str
-    assignees: Union[Unset, list[str]] = UNSET
+    assignees: Union[None, Unset, list[str]] = UNSET
     assignee: Union[None, Unset, str] = UNSET
     tags: Union[Unset, list[str]] = UNSET
     priority: Union[None, Priority, Unset] = UNSET
@@ -56,9 +62,12 @@ class ConciseTask:
     due_at: Union[None, Unset, str] = UNSET
     size: Union[None, Unset, int, str] = UNSET
     time_tracking: Union[Unset, str] = UNSET
+    custom_properties: Union["CustomProperties", 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
+
         id = self.id
 
         html_url = self.html_url
@@ -74,8 +83,13 @@ class ConciseTask:
 
         status = self.status
 
-        assignees: Union[Unset, list[str]] = UNSET
-        if not isinstance(self.assignees, Unset):
+        assignees: Union[None, Unset, list[str]]
+        if isinstance(self.assignees, Unset):
+            assignees = UNSET
+        elif isinstance(self.assignees, list):
+            assignees = self.assignees
+
+        else:
             assignees = self.assignees
 
         assignee: Union[None, Unset, str]
@@ -116,6 +130,14 @@ class ConciseTask:
 
         time_tracking = self.time_tracking
 
+        custom_properties: Union[None, Unset, dict[str, Any]]
+        if isinstance(self.custom_properties, Unset):
+            custom_properties = UNSET
+        elif isinstance(self.custom_properties, CustomProperties):
+            custom_properties = self.custom_properties.to_dict()
+        else:
+            custom_properties = self.custom_properties
+
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
@@ -145,11 +167,15 @@ class ConciseTask:
             field_dict["size"] = size
         if time_tracking is not UNSET:
             field_dict["timeTracking"] = time_tracking
+        if custom_properties is not UNSET:
+            field_dict["customProperties"] = custom_properties
 
         return field_dict
 
     @classmethod
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.custom_properties import CustomProperties
+
         d = dict(src_dict)
         id = d.pop("id")
 
@@ -170,7 +196,22 @@ class ConciseTask:
 
         status = d.pop("status")
 
-        assignees = cast(list[str], d.pop("assignees", UNSET))
+        def _parse_assignees(data: object) -> Union[None, Unset, list[str]]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, list):
+                    raise TypeError()
+                assignees_type_0 = cast(list[str], data)
+
+                return assignees_type_0
+            except:  # noqa: E722
+                pass
+            return cast(Union[None, Unset, list[str]], data)
+
+        assignees = _parse_assignees(d.pop("assignees", UNSET))
 
         def _parse_assignee(data: object) -> Union[None, Unset, str]:
             if data is None:
@@ -229,6 +270,25 @@ class ConciseTask:
 
         time_tracking = d.pop("timeTracking", UNSET)
 
+        def _parse_custom_properties(
+            data: object,
+        ) -> Union["CustomProperties", None, Unset]:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, dict):
+                    raise TypeError()
+                custom_properties_type_0 = CustomProperties.from_dict(data)
+
+                return custom_properties_type_0
+            except:  # noqa: E722
+                pass
+            return cast(Union["CustomProperties", None, Unset], data)
+
+        custom_properties = _parse_custom_properties(d.pop("customProperties", UNSET))
+
         concise_task = cls(
             id=id,
             html_url=html_url,
@@ -245,6 +305,7 @@ class ConciseTask:
             due_at=due_at,
             size=size,
             time_tracking=time_tracking,
+            custom_properties=custom_properties,
         )
 
         concise_task.additional_properties = d

dart_tools-0.7.3/dart/generated/models/custom_properties.py

@@ -0,0 +1,131 @@
+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
+
+T = TypeVar("T", bound="CustomProperties")
+
+
+@_attrs_define
+class CustomProperties:
+    """
+    Example:
+        {'customCheckboxProperty': True, 'customDatesProperty': '2025-05-10', 'customDatesPropertyWithRange':
+            ['2025-05-01', '2025-05-30'], 'customMultiselectProperty': ['frontend', 'bug'],
+            'customNumberPropertyWithIntegerFormat': 5, 'customNumberPropertyWithPercentageFormat': 75,
+            'customNumberPropertyWithDollarsFormat': 1500.5, 'customSelectProperty': 'In Progress', 'customStatusProperty':
+            'Blocked', 'customTextProperty': 'This task requires additional review from the design team',
+            'customUserProperty': 'john.doe@example.com', 'customMultipleUserProperty': ['john.doe@example.com', 'Alice
+            Smith']}
+
+    """
+
+    additional_properties: dict[str, Union[None, bool, float, list[Union[None, str]], list[str], str]] = _attrs_field(
+        init=False, factory=dict
+    )
+
+    def to_dict(self) -> dict[str, Any]:
+        field_dict: dict[str, Any] = {}
+        for prop_name, prop in self.additional_properties.items():
+            if isinstance(prop, list):
+                field_dict[prop_name] = []
+                for additional_property_type_1_type_0_item_data in prop:
+                    additional_property_type_1_type_0_item: Union[None, str]
+                    additional_property_type_1_type_0_item = additional_property_type_1_type_0_item_data
+                    field_dict[prop_name].append(additional_property_type_1_type_0_item)
+
+            elif isinstance(prop, list):
+                field_dict[prop_name] = prop
+
+            elif isinstance(prop, list):
+                field_dict[prop_name] = prop
+
+            else:
+                field_dict[prop_name] = prop
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        custom_properties = cls()
+
+        additional_properties = {}
+        for prop_name, prop_dict in d.items():
+
+            def _parse_additional_property(
+                data: object,
+            ) -> Union[None, bool, float, list[Union[None, str]], list[str], str]:
+                if data is None:
+                    return data
+                try:
+                    if not isinstance(data, list):
+                        raise TypeError()
+                    additional_property_type_1_type_0 = []
+                    _additional_property_type_1_type_0 = data
+                    for additional_property_type_1_type_0_item_data in _additional_property_type_1_type_0:
+
+                        def _parse_additional_property_type_1_type_0_item(
+                            data: object,
+                        ) -> Union[None, str]:
+                            if data is None:
+                                return data
+                            return cast(Union[None, str], data)
+
+                        additional_property_type_1_type_0_item = _parse_additional_property_type_1_type_0_item(
+                            additional_property_type_1_type_0_item_data
+                        )
+
+                        additional_property_type_1_type_0.append(additional_property_type_1_type_0_item)
+
+                    return additional_property_type_1_type_0
+                except:  # noqa: E722
+                    pass
+                try:
+                    if not isinstance(data, list):
+                        raise TypeError()
+                    additional_property_type_3 = cast(list[str], data)
+
+                    return additional_property_type_3
+                except:  # noqa: E722
+                    pass
+                try:
+                    if not isinstance(data, list):
+                        raise TypeError()
+                    additional_property_type_9 = cast(list[str], data)
+
+                    return additional_property_type_9
+                except:  # noqa: E722
+                    pass
+                return cast(
+                    Union[None, bool, float, list[Union[None, str]], list[str], str],
+                    data,
+                )
+
+            additional_property = _parse_additional_property(prop_dict)
+
+            additional_properties[prop_name] = additional_property
+
+        custom_properties.additional_properties = additional_properties
+        return custom_properties
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Union[None, bool, float, list[Union[None, str]], list[str], str]:
+        return self.additional_properties[key]
+
+    def __setitem__(
+        self,
+        key: str,
+        value: Union[None, bool, float, list[Union[None, str]], list[str], str],
+    ) -> 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