dart-tools 0.7.4__tar.gz → 0.7.6__tar.gz

{dart_tools-0.7.4/dart_tools.egg-info → dart_tools-0.7.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dart-tools
-Version: 0.7.4
+Version: 0.7.6
 Summary: The Dart CLI and Python Library
 Author-email: Dart <software@itsdart.com>
 License: MIT License

{dart_tools-0.7.4 → dart_tools-0.7.6}/dart/dart.py

@@ -36,6 +36,7 @@ from .generated.models import (
     Doc,
     DocCreate,
     DocUpdate,
+    PaginatedCommentList,
     PaginatedConciseDocList,
     PaginatedConciseTaskList,
     Priority,
@@ -100,6 +101,7 @@ _PRIORITY_MAP: dict[int, str] = {
     3: Priority.LOW,
 }
 _SIZES = {1, 2, 3, 5, 8}
+_DEFAULT_DARTBOARD = "General/Active"
 
 _VERSION = version(_APP)
 _AUTH_TOKEN_ENVVAR = os.environ.get(_AUTH_TOKEN_ENVVAR_KEY)
@@ -334,6 +336,11 @@ class Dart:
         response = api.create_comment.sync_detailed(client=self._public_api, body=body)
         return _get_response_parsed(response)
 
+    @_handle_request_errors
+    def list_comments(self, **kwargs) -> PaginatedCommentList:
+        response = api.list_comments.sync_detailed(client=self._public_api, **kwargs)
+        return _get_response_parsed(response)
+
     @_handle_request_errors
     def create_doc(self, body: WrappedDocCreate) -> WrappedDoc:
         response = api.create_doc.sync_detailed(client=self._public_api, body=body)
@@ -498,6 +505,10 @@ def login(token: str | None = None) -> bool:
     config = _Config()
     dart = Dart(config=config)
 
+    if dart.is_logged_in():
+        _log("Already logged in.")
+        return True
+
     _log("Log in to Dart")
     if token is None:
         if not _is_cli:
@@ -535,7 +546,9 @@ def begin_task() -> bool:
     dart = Dart()
     config = dart.get_config()
     user = config.user
-    filtered_tasks = dart.list_tasks(assignee=user.email, is_completed=False).results
+    print(config.dartboards)
+    dartboard_maybe = {"dartboard": _DEFAULT_DARTBOARD} if _DEFAULT_DARTBOARD in config.dartboards else {}
+    filtered_tasks = dart.list_tasks(assignee=user.email, is_completed=False, **dartboard_maybe).results
 
     if not filtered_tasks:
         _dart_exit("No active, incomplete tasks found.")

{dart_tools-0.7.4 → dart_tools-0.7.6}/dart/generated/api/__init__.py

@@ -1,6 +1,6 @@
 """Contains methods for accessing the API"""
 
-from .comment import create_comment
+from .comment import create_comment, list_comments
 from .config import get_config
 from .dartboard import retrieve_dartboard
 from .doc import create_doc, delete_doc, list_docs, retrieve_doc, update_doc

dart_tools-0.7.6/dart/generated/api/comment/list_comments.py

@@ -0,0 +1,351 @@
+import datetime
+from http import HTTPStatus
+from typing import Any, Optional, Union
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.list_comments_o_item import ListCommentsOItem
+from ...models.paginated_comment_list import PaginatedCommentList
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    *,
+    author: Union[Unset, str] = UNSET,
+    author_id: Union[Unset, str] = UNSET,
+    ids: Union[Unset, str] = UNSET,
+    limit: Union[Unset, int] = UNSET,
+    o: Union[Unset, list[ListCommentsOItem]] = UNSET,
+    offset: Union[Unset, int] = UNSET,
+    parent_id: Union[None, Unset, str] = UNSET,
+    published_at_after: Union[Unset, datetime.datetime] = UNSET,
+    published_at_before: Union[Unset, datetime.datetime] = UNSET,
+    task: Union[Unset, str] = UNSET,
+    task_id: str,
+    text: Union[Unset, str] = UNSET,
+) -> dict[str, Any]:
+    params: dict[str, Any] = {}
+
+    params["author"] = author
+
+    params["author_id"] = author_id
+
+    params["ids"] = ids
+
+    params["limit"] = limit
+
+    json_o: Union[Unset, list[str]] = UNSET
+    if not isinstance(o, Unset):
+        json_o = []
+        for o_item_data in o:
+            o_item = o_item_data.value
+            json_o.append(o_item)
+
+    params["o"] = json_o
+
+    params["offset"] = offset
+
+    json_parent_id: Union[None, Unset, str]
+    if isinstance(parent_id, Unset):
+        json_parent_id = UNSET
+    else:
+        json_parent_id = parent_id
+    params["parent_id"] = json_parent_id
+
+    json_published_at_after: Union[Unset, str] = UNSET
+    if not isinstance(published_at_after, Unset):
+        json_published_at_after = published_at_after.isoformat()
+    params["published_at_after"] = json_published_at_after
+
+    json_published_at_before: Union[Unset, str] = UNSET
+    if not isinstance(published_at_before, Unset):
+        json_published_at_before = published_at_before.isoformat()
+    params["published_at_before"] = json_published_at_before
+
+    params["task"] = task
+
+    params["task_id"] = task_id
+
+    params["text"] = text
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/comments/list",
+        "params": params,
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[PaginatedCommentList]:
+    if response.status_code == 200:
+        response_200 = PaginatedCommentList.from_dict(response.json())
+
+        return response_200
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Response[PaginatedCommentList]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: Union[AuthenticatedClient, Client],
+    author: Union[Unset, str] = UNSET,
+    author_id: Union[Unset, str] = UNSET,
+    ids: Union[Unset, str] = UNSET,
+    limit: Union[Unset, int] = UNSET,
+    o: Union[Unset, list[ListCommentsOItem]] = UNSET,
+    offset: Union[Unset, int] = UNSET,
+    parent_id: Union[None, Unset, str] = UNSET,
+    published_at_after: Union[Unset, datetime.datetime] = UNSET,
+    published_at_before: Union[Unset, datetime.datetime] = UNSET,
+    task: Union[Unset, str] = UNSET,
+    task_id: str,
+    text: Union[Unset, str] = UNSET,
+) -> Response[PaginatedCommentList]:
+    """List all comments that the user has access to. This will return a list of comments, including the
+    text, associated task ID, and others. Comments are ordered by thread and then by when they were
+    written.
+
+    Args:
+        author (Union[Unset, str]):
+        author_id (Union[Unset, str]):
+        ids (Union[Unset, str]):
+        limit (Union[Unset, int]):
+        o (Union[Unset, list[ListCommentsOItem]]):
+        offset (Union[Unset, int]):
+        parent_id (Union[None, Unset, str]):
+        published_at_after (Union[Unset, datetime.datetime]):
+        published_at_before (Union[Unset, datetime.datetime]):
+        task (Union[Unset, str]):
+        task_id (str):
+        text (Union[Unset, str]):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[PaginatedCommentList]
+    """
+
+    kwargs = _get_kwargs(
+        author=author,
+        author_id=author_id,
+        ids=ids,
+        limit=limit,
+        o=o,
+        offset=offset,
+        parent_id=parent_id,
+        published_at_after=published_at_after,
+        published_at_before=published_at_before,
+        task=task,
+        task_id=task_id,
+        text=text,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: Union[AuthenticatedClient, Client],
+    author: Union[Unset, str] = UNSET,
+    author_id: Union[Unset, str] = UNSET,
+    ids: Union[Unset, str] = UNSET,
+    limit: Union[Unset, int] = UNSET,
+    o: Union[Unset, list[ListCommentsOItem]] = UNSET,
+    offset: Union[Unset, int] = UNSET,
+    parent_id: Union[None, Unset, str] = UNSET,
+    published_at_after: Union[Unset, datetime.datetime] = UNSET,
+    published_at_before: Union[Unset, datetime.datetime] = UNSET,
+    task: Union[Unset, str] = UNSET,
+    task_id: str,
+    text: Union[Unset, str] = UNSET,
+) -> Optional[PaginatedCommentList]:
+    """List all comments that the user has access to. This will return a list of comments, including the
+    text, associated task ID, and others. Comments are ordered by thread and then by when they were
+    written.
+
+    Args:
+        author (Union[Unset, str]):
+        author_id (Union[Unset, str]):
+        ids (Union[Unset, str]):
+        limit (Union[Unset, int]):
+        o (Union[Unset, list[ListCommentsOItem]]):
+        offset (Union[Unset, int]):
+        parent_id (Union[None, Unset, str]):
+        published_at_after (Union[Unset, datetime.datetime]):
+        published_at_before (Union[Unset, datetime.datetime]):
+        task (Union[Unset, str]):
+        task_id (str):
+        text (Union[Unset, str]):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        PaginatedCommentList
+    """
+
+    return sync_detailed(
+        client=client,
+        author=author,
+        author_id=author_id,
+        ids=ids,
+        limit=limit,
+        o=o,
+        offset=offset,
+        parent_id=parent_id,
+        published_at_after=published_at_after,
+        published_at_before=published_at_before,
+        task=task,
+        task_id=task_id,
+        text=text,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: Union[AuthenticatedClient, Client],
+    author: Union[Unset, str] = UNSET,
+    author_id: Union[Unset, str] = UNSET,
+    ids: Union[Unset, str] = UNSET,
+    limit: Union[Unset, int] = UNSET,
+    o: Union[Unset, list[ListCommentsOItem]] = UNSET,
+    offset: Union[Unset, int] = UNSET,
+    parent_id: Union[None, Unset, str] = UNSET,
+    published_at_after: Union[Unset, datetime.datetime] = UNSET,
+    published_at_before: Union[Unset, datetime.datetime] = UNSET,
+    task: Union[Unset, str] = UNSET,
+    task_id: str,
+    text: Union[Unset, str] = UNSET,
+) -> Response[PaginatedCommentList]:
+    """List all comments that the user has access to. This will return a list of comments, including the
+    text, associated task ID, and others. Comments are ordered by thread and then by when they were
+    written.
+
+    Args:
+        author (Union[Unset, str]):
+        author_id (Union[Unset, str]):
+        ids (Union[Unset, str]):
+        limit (Union[Unset, int]):
+        o (Union[Unset, list[ListCommentsOItem]]):
+        offset (Union[Unset, int]):
+        parent_id (Union[None, Unset, str]):
+        published_at_after (Union[Unset, datetime.datetime]):
+        published_at_before (Union[Unset, datetime.datetime]):
+        task (Union[Unset, str]):
+        task_id (str):
+        text (Union[Unset, str]):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[PaginatedCommentList]
+    """
+
+    kwargs = _get_kwargs(
+        author=author,
+        author_id=author_id,
+        ids=ids,
+        limit=limit,
+        o=o,
+        offset=offset,
+        parent_id=parent_id,
+        published_at_after=published_at_after,
+        published_at_before=published_at_before,
+        task=task,
+        task_id=task_id,
+        text=text,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: Union[AuthenticatedClient, Client],
+    author: Union[Unset, str] = UNSET,
+    author_id: Union[Unset, str] = UNSET,
+    ids: Union[Unset, str] = UNSET,
+    limit: Union[Unset, int] = UNSET,
+    o: Union[Unset, list[ListCommentsOItem]] = UNSET,
+    offset: Union[Unset, int] = UNSET,
+    parent_id: Union[None, Unset, str] = UNSET,
+    published_at_after: Union[Unset, datetime.datetime] = UNSET,
+    published_at_before: Union[Unset, datetime.datetime] = UNSET,
+    task: Union[Unset, str] = UNSET,
+    task_id: str,
+    text: Union[Unset, str] = UNSET,
+) -> Optional[PaginatedCommentList]:
+    """List all comments that the user has access to. This will return a list of comments, including the
+    text, associated task ID, and others. Comments are ordered by thread and then by when they were
+    written.
+
+    Args:
+        author (Union[Unset, str]):
+        author_id (Union[Unset, str]):
+        ids (Union[Unset, str]):
+        limit (Union[Unset, int]):
+        o (Union[Unset, list[ListCommentsOItem]]):
+        offset (Union[Unset, int]):
+        parent_id (Union[None, Unset, str]):
+        published_at_after (Union[Unset, datetime.datetime]):
+        published_at_before (Union[Unset, datetime.datetime]):
+        task (Union[Unset, str]):
+        task_id (str):
+        text (Union[Unset, str]):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        PaginatedCommentList
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            author=author,
+            author_id=author_id,
+            ids=ids,
+            limit=limit,
+            o=o,
+            offset=offset,
+            parent_id=parent_id,
+            published_at_after=published_at_after,
+            published_at_before=published_at_before,
+            task=task,
+            task_id=task_id,
+            text=text,
+        )
+    ).parsed

{dart_tools-0.7.4 → dart_tools-0.7.6}/dart/generated/models/__init__.py

@@ -10,12 +10,15 @@ from .doc import Doc
 from .doc_create import DocCreate
 from .doc_update import DocUpdate
 from .folder import Folder
+from .list_comments_o_item import ListCommentsOItem
 from .list_docs_o_item import ListDocsOItem
+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 .task import Task
 from .task_create import TaskCreate
+from .task_relationships import TaskRelationships
 from .task_update import TaskUpdate
 from .user import User
 from .user_space_configuration import UserSpaceConfiguration
@@ -73,12 +76,15 @@ __all__ = (
     "DocCreate",
     "DocUpdate",
     "Folder",
+    "ListCommentsOItem",
     "ListDocsOItem",
+    "PaginatedCommentList",
     "PaginatedConciseDocList",
     "PaginatedConciseTaskList",
     "Priority",
     "Task",
     "TaskCreate",
+    "TaskRelationships",
     "TaskUpdate",
     "User",
     "UserSpaceConfiguration",

{dart_tools-0.7.4 → dart_tools-0.7.6}/dart/generated/models/comment.py

@@ -1,9 +1,11 @@
 from collections.abc import Mapping
-from typing import Any, TypeVar
+from typing import Any, TypeVar, Union
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 
+from ..types import UNSET, Unset
+
 T = TypeVar("T", bound="Comment")
 
 
@@ -13,16 +15,18 @@ class Comment:
     Attributes:
         id (str): The universal, unique ID of the comment.
         html_url (str): The URL that can be used to open the comment in the Dart web UI.
-        task_id (str): The universal, unique ID of the task that the comment is associated with.
         author (str): The name or email of the user that authored the comment.
+        task_id (str): The universal, unique ID of the task that the comment is associated with.
         text (str): The full content of the comment, which can include markdown formatting.
+        parent_id (Union[Unset, str]): The universal, unique ID of the parent comment, if any.
     """
 
     id: str
     html_url: str
-    task_id: str
     author: str
+    task_id: str
     text: str
+    parent_id: Union[Unset, str] = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
@@ -30,23 +34,27 @@ class Comment:
 
         html_url = self.html_url
 
-        task_id = self.task_id
-
         author = self.author
 
+        task_id = self.task_id
+
         text = self.text
 
+        parent_id = self.parent_id
+
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
             {
                 "id": id,
                 "htmlUrl": html_url,
-                "taskId": task_id,
                 "author": author,
+                "taskId": task_id,
                 "text": text,
             }
         )
+        if parent_id is not UNSET:
+            field_dict["parentId"] = parent_id
 
         return field_dict
 
@@ -57,18 +65,21 @@ class Comment:
 
         html_url = d.pop("htmlUrl")
 
-        task_id = d.pop("taskId")
-
         author = d.pop("author")
 
+        task_id = d.pop("taskId")
+
         text = d.pop("text")
 
+        parent_id = d.pop("parentId", UNSET)
+
         comment = cls(
             id=id,
             html_url=html_url,
-            task_id=task_id,
             author=author,
+            task_id=task_id,
             text=text,
+            parent_id=parent_id,
         )
 
         comment.additional_properties = d

{dart_tools-0.7.4 → dart_tools-0.7.6}/dart/generated/models/comment_create.py

@@ -1,9 +1,11 @@
 from collections.abc import Mapping
-from typing import Any, TypeVar
+from typing import Any, TypeVar, Union
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 
+from ..types import UNSET, Unset
+
 T = TypeVar("T", bound="CommentCreate")
 
 
@@ -13,10 +15,12 @@ class CommentCreate:
     Attributes:
         task_id (str): The universal, unique ID of the task that the comment is associated with.
         text (str): The full content of the comment, which can include markdown formatting.
+        parent_id (Union[Unset, str]): The universal, unique ID of the parent comment, if any.
     """
 
     task_id: str
     text: str
+    parent_id: Union[Unset, str] = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
@@ -24,6 +28,8 @@ class CommentCreate:
 
         text = self.text
 
+        parent_id = self.parent_id
+
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
@@ -32,6 +38,8 @@ class CommentCreate:
                 "text": text,
             }
         )
+        if parent_id is not UNSET:
+            field_dict["parentId"] = parent_id
 
         return field_dict
 
@@ -42,9 +50,12 @@ class CommentCreate:
 
         text = d.pop("text")
 
+        parent_id = d.pop("parentId", UNSET)
+
         comment_create = cls(
             task_id=task_id,
             text=text,
+            parent_id=parent_id,
         )
 
         comment_create.additional_properties = d

dart_tools-0.7.6/dart/generated/models/list_comments_o_item.py

@@ -0,0 +1,10 @@
+from enum import Enum
+
+
+class ListCommentsOItem(str, Enum):
+    HIERARCHICAL = "hierarchical"
+    PUBLISHED_AT = "published_at"
+    PUBLISHED_AT_DESC = "-published_at"
+
+    def __str__(self) -> str:
+        return str(self.value)