dart-tools 0.8.6__py3-none-any.whl → 0.8.8__py3-none-any.whl

dart/dart.py

@@ -374,70 +374,10 @@ class Dart:
         self._private_api.get_httpx_client().post(_COPY_BRANCH_URL_FRAG, json={"duid": id})
 
 
-class _Git:
-    @staticmethod
-    def _cmd_succeeds(cmd: str) -> bool:
-        try:
-            _run_cmd(f"{cmd} 2>&1")
-        except subprocess.CalledProcessError as ex:
-            if "128" in str(ex):
-                return False
-            raise ex
-        return True
-
-    @staticmethod
-    def make_task_name(email: str, task: ConciseTask | Task) -> str:
-        username = slugify_str(email.split("@")[0], lower=True)
-        title = slugify_str(task.title, lower=True)
-        return trim_slug_str(f"{username}/{task.id}-{title}", length=60)
-
-    @staticmethod
-    def get_current_branch() -> str:
-        return _run_cmd("git rev-parse --abbrev-ref HEAD").strip()
-
-    @staticmethod
-    def ensure_in_repo() -> None:
-        if _Git._cmd_succeeds("git rev-parse --is-inside-work-tree"):
-            return
-        _dart_exit("You are not in a git repo.")
-
-    @staticmethod
-    def ensure_no_unstaged_changes() -> None:
-        if _run_cmd("git status --porcelain") == "":
-            return
-        _dart_exit("You have uncommitted changes. Please commit or stash them.")
-
-    @staticmethod
-    def ensure_on_main_or_intended() -> None:
-        branch = _Git.get_current_branch()
-        if branch == "main":
-            return
-        if (
-            pick(
-                ["Yes", "No"],
-                "You're not on the 'main' branch. Is this intentional?",
-                "→",
-            )[0]
-            == "Yes"
-        ):
-            return
-        _run_cmd("git checkout main")
-
-    @staticmethod
-    def branch_exists(branch: str) -> bool:
-        return _Git._cmd_succeeds(f"git rev-parse --verify {branch}")
-
-    @staticmethod
-    def checkout_branch(branch: str) -> None:
-        if _Git.branch_exists(branch):
-            _run_cmd(f"git checkout {branch}")
-            return
-
-        if _Git.branch_exists(f"origin/{branch}"):
-            _run_cmd(f"git checkout --track origin/{branch}")
-            return
-
-        _run_cmd(f"git checkout -b {branch}")
+def make_task_branch_name(email: str, task: ConciseTask | Task) -> str:
+    username = slugify_str(email.split("@")[0], lower=True)
+    title = slugify_str(task.title, lower=True)
+    return trim_slug_str(f"{username}/{task.id}-{title}", length=60)
 
 
 def get_host() -> str:
@@ -530,26 +470,11 @@ def login(token: str | None = None) -> bool:
     return True
 
 
-def _begin_task(dart: Dart, email: str, task: ConciseTask | Task) -> bool:
-    _Git.ensure_in_repo()
-    _Git.ensure_no_unstaged_changes()
-    _Git.ensure_on_main_or_intended()
-
-    dart = Dart()
-    dart.copy_branch_link(task.id)
-
-    branch_name = _Git.make_task_name(email, task)
-    _Git.checkout_branch(branch_name)
-
-    _log(f"Started work on\n\n  {task.title}\n  {task.html_url}\n")
-    return True
-
 
 def begin_task() -> bool:
     dart = Dart()
     config = dart.get_config()
     user = config.user
-    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
 
@@ -563,9 +488,10 @@ def begin_task() -> bool:
     )[1]
     assert isinstance(picked_idx, int)
 
-    _begin_task(dart, user.email, filtered_tasks[picked_idx])
+    task = filtered_tasks[picked_idx]
+    branch_name = make_task_branch_name(user.email, task)
 
-    _log("Done.")
+    _log(json.dumps({"title": task.title, "branch": branch_name, "id": task.id}))
     return True
 
 
@@ -601,7 +527,6 @@ def create_task(
     priority_int: Union[int, None, Unset] = UNSET,
     size_int: Union[int, None, Unset] = UNSET,
     due_at_str: Union[str, None, Unset] = UNSET,
-    should_begin: bool = False,
 ) -> Task:
     dart = Dart()
     task_create = WrappedTaskCreate(
@@ -619,11 +544,6 @@ def create_task(
     task = dart.create_task(task_create).item
     _log(f"Created task\n\n  {task.title}\n  {task.html_url}\n  ID: {task.id}\n")
 
-    if should_begin:
-        user = dart.get_config().user
-        _begin_task(dart, user.email, task)
-
-    _log("Done.")
     return task
 
 
@@ -819,13 +739,6 @@ def cli() -> None:
         _CREATE_TASK_CMD, aliases=["tc"], help=_HELP_TEXT_TO_COMMAND[_CREATE_TASK_CMD]
     )
     create_task_parser.add_argument("title", help="title of the task")
-    create_task_parser.add_argument(
-        "-b",
-        "--begin",
-        dest="should_begin",
-        action="store_true",
-        help="begin work on the task after creation",
-    )
     _add_standard_task_arguments(create_task_parser)
     create_task_parser.set_defaults(func=create_task)
 

dart/generated/api/__init__.py

@@ -8,5 +8,5 @@ from .doc import create_doc, delete_doc, get_doc, list_docs, update_doc
 from .folder import get_folder
 from .help_center_article import list_help_center_articles
 from .skill import retrieve_skill_by_title
-from .task import create_task, delete_task, get_task, list_tasks, update_task
+from .task import add_task_time_tracking, create_task, delete_task, get_task, list_tasks, move_task, update_task
 from .view import get_view

dart/generated/api/task/add_task_time_tracking.py

@@ -0,0 +1,190 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union, cast
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.task_time_tracking_create import TaskTimeTrackingCreate
+from ...models.wrapped_task import WrappedTask
+from ...types import Response
+
+
+def _get_kwargs(
+    id: str,
+    *,
+    body: TaskTimeTrackingCreate,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/tasks/{id}/time-tracking".format(
+            id=id,
+        ),
+    }
+
+    _body = body.to_dict()
+
+    _kwargs["json"] = _body
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[Union[Any, WrappedTask]]:
+    if response.status_code == 200:
+        response_200 = WrappedTask.from_dict(response.json())
+
+        return response_200
+    if response.status_code == 400:
+        response_400 = cast(Any, None)
+        return response_400
+    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[Union[Any, WrappedTask]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskTimeTrackingCreate,
+) -> Response[Union[Any, WrappedTask]]:
+    """Add a time tracking entry to a task
+
+     Record an additional time tracking entry on a task and return the updated task with refreshed time
+    tracking.
+
+    Args:
+        id (str):
+        body (TaskTimeTrackingCreate):
+
+    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[Union[Any, WrappedTask]]
+    """
+
+    kwargs = _get_kwargs(
+        id=id,
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskTimeTrackingCreate,
+) -> Optional[Union[Any, WrappedTask]]:
+    """Add a time tracking entry to a task
+
+     Record an additional time tracking entry on a task and return the updated task with refreshed time
+    tracking.
+
+    Args:
+        id (str):
+        body (TaskTimeTrackingCreate):
+
+    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:
+        Union[Any, WrappedTask]
+    """
+
+    return sync_detailed(
+        id=id,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskTimeTrackingCreate,
+) -> Response[Union[Any, WrappedTask]]:
+    """Add a time tracking entry to a task
+
+     Record an additional time tracking entry on a task and return the updated task with refreshed time
+    tracking.
+
+    Args:
+        id (str):
+        body (TaskTimeTrackingCreate):
+
+    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[Union[Any, WrappedTask]]
+    """
+
+    kwargs = _get_kwargs(
+        id=id,
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskTimeTrackingCreate,
+) -> Optional[Union[Any, WrappedTask]]:
+    """Add a time tracking entry to a task
+
+     Record an additional time tracking entry on a task and return the updated task with refreshed time
+    tracking.
+
+    Args:
+        id (str):
+        body (TaskTimeTrackingCreate):
+
+    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:
+        Union[Any, WrappedTask]
+    """
+
+    return (
+        await asyncio_detailed(
+            id=id,
+            client=client,
+            body=body,
+        )
+    ).parsed

dart/generated/api/task/move_task.py

@@ -0,0 +1,190 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union, cast
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.task_move import TaskMove
+from ...models.wrapped_task import WrappedTask
+from ...types import Response
+
+
+def _get_kwargs(
+    id: str,
+    *,
+    body: TaskMove,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/tasks/{id}/move".format(
+            id=id,
+        ),
+    }
+
+    _body = body.to_dict()
+
+    _kwargs["json"] = _body
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[Union[Any, WrappedTask]]:
+    if response.status_code == 200:
+        response_200 = WrappedTask.from_dict(response.json())
+
+        return response_200
+    if response.status_code == 400:
+        response_400 = cast(Any, None)
+        return response_400
+    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[Union[Any, WrappedTask]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskMove,
+) -> Response[Union[Any, WrappedTask]]:
+    """Move a task within its dartboard
+
+     Move a task to a specific position within results sorted by the order field. Use afterTaskId to
+    place the task after a specific task, or beforeTaskId to place it before one.
+
+    Args:
+        id (str):
+        body (TaskMove):
+
+    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[Union[Any, WrappedTask]]
+    """
+
+    kwargs = _get_kwargs(
+        id=id,
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskMove,
+) -> Optional[Union[Any, WrappedTask]]:
+    """Move a task within its dartboard
+
+     Move a task to a specific position within results sorted by the order field. Use afterTaskId to
+    place the task after a specific task, or beforeTaskId to place it before one.
+
+    Args:
+        id (str):
+        body (TaskMove):
+
+    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:
+        Union[Any, WrappedTask]
+    """
+
+    return sync_detailed(
+        id=id,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskMove,
+) -> Response[Union[Any, WrappedTask]]:
+    """Move a task within its dartboard
+
+     Move a task to a specific position within results sorted by the order field. Use afterTaskId to
+    place the task after a specific task, or beforeTaskId to place it before one.
+
+    Args:
+        id (str):
+        body (TaskMove):
+
+    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[Union[Any, WrappedTask]]
+    """
+
+    kwargs = _get_kwargs(
+        id=id,
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskMove,
+) -> Optional[Union[Any, WrappedTask]]:
+    """Move a task within its dartboard
+
+     Move a task to a specific position within results sorted by the order field. Use afterTaskId to
+    place the task after a specific task, or beforeTaskId to place it before one.
+
+    Args:
+        id (str):
+        body (TaskMove):
+
+    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:
+        Union[Any, WrappedTask]
+    """
+
+    return (
+        await asyncio_detailed(
+            id=id,
+            client=client,
+            body=body,
+        )
+    ).parsed

dart/generated/models/__init__.py

@@ -16,13 +16,27 @@ from .list_comments_o_item import ListCommentsOItem
 from .list_docs_o_item import ListDocsOItem
 from .list_tasks_o_item import ListTasksOItem
 from .paginated_comment_list import PaginatedCommentList
+from .paginated_comment_list_meta_type_0 import PaginatedCommentListMetaType0
+from .paginated_comment_list_meta_type_0_applied_default_filters import (
+    PaginatedCommentListMetaType0AppliedDefaultFilters,
+)
 from .paginated_concise_doc_list import PaginatedConciseDocList
+from .paginated_concise_doc_list_meta_type_0 import PaginatedConciseDocListMetaType0
+from .paginated_concise_doc_list_meta_type_0_applied_default_filters import (
+    PaginatedConciseDocListMetaType0AppliedDefaultFilters,
+)
 from .paginated_concise_task_list import PaginatedConciseTaskList
+from .paginated_concise_task_list_meta_type_0 import PaginatedConciseTaskListMetaType0
+from .paginated_concise_task_list_meta_type_0_applied_default_filters import (
+    PaginatedConciseTaskListMetaType0AppliedDefaultFilters,
+)
 from .priority import Priority
 from .skill import Skill
 from .task import Task
 from .task_create import TaskCreate
+from .task_move import TaskMove
 from .task_relationships_type_0 import TaskRelationshipsType0
+from .task_time_tracking_create import TaskTimeTrackingCreate
 from .task_update import TaskUpdate
 from .time_tracking_entry import TimeTrackingEntry
 from .user import User
@@ -89,13 +103,21 @@ __all__ = (
     "ListDocsOItem",
     "ListTasksOItem",
     "PaginatedCommentList",
+    "PaginatedCommentListMetaType0",
+    "PaginatedCommentListMetaType0AppliedDefaultFilters",
     "PaginatedConciseDocList",
+    "PaginatedConciseDocListMetaType0",
+    "PaginatedConciseDocListMetaType0AppliedDefaultFilters",
     "PaginatedConciseTaskList",
+    "PaginatedConciseTaskListMetaType0",
+    "PaginatedConciseTaskListMetaType0AppliedDefaultFilters",
     "Priority",
     "Skill",
     "Task",
     "TaskCreate",
+    "TaskMove",
     "TaskRelationshipsType0",
+    "TaskTimeTrackingCreate",
     "TaskUpdate",
     "TimeTrackingEntry",
     "User",

dart/generated/models/custom_properties.py

@@ -21,8 +21,8 @@ class CustomProperties:
 
     """
 
-    additional_properties: dict[str, Union[None, bool, float, list[Union[None, str]], list[str], str]] = _attrs_field(
-        init=False, factory=dict
+    additional_properties: dict[str, Union[None, bool, float, int, list[Union[None, str]], list[str], str]] = (
+        _attrs_field(init=False, factory=dict)
     )
 
     def to_dict(self) -> dict[str, Any]:
@@ -56,7 +56,7 @@ class CustomProperties:
 
             def _parse_additional_property(
                 data: object,
-            ) -> Union[None, bool, float, list[Union[None, str]], list[str], str]:
+            ) -> Union[None, bool, float, int, list[Union[None, str]], list[str], str]:
                 if data is None:
                     return data
                 try:
@@ -93,13 +93,13 @@ class CustomProperties:
                 try:
                     if not isinstance(data, list):
                         raise TypeError()
-                    additional_property_type_9 = cast(list[str], data)
+                    additional_property_type_11 = cast(list[str], data)
 
-                    return additional_property_type_9
+                    return additional_property_type_11
                 except:  # noqa: E722
                     pass
                 return cast(
-                    Union[None, bool, float, list[Union[None, str]], list[str], str],
+                    Union[None, bool, float, int, list[Union[None, str]], list[str], str],
                     data,
                 )
 
@@ -114,13 +114,13 @@ class CustomProperties:
     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]:
+    def __getitem__(self, key: str) -> Union[None, bool, float, int, 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],
+        value: Union[None, bool, float, int, list[Union[None, str]], list[str], str],
     ) -> None:
         self.additional_properties[key] = value
 

dart/generated/models/list_docs_o_item.py

@@ -7,11 +7,11 @@ class ListDocsOItem(str, Enum):
     ORDER = "order"
     TITLE = "title"
     UPDATED_AT = "updated_at"
-    VALUE_0 = "-created_at"
-    VALUE_1 = "-folder__order"
-    VALUE_2 = "-order"
-    VALUE_3 = "-title"
-    VALUE_4 = "-updated_at"
+    CREATED_AT_DESC = "-created_at"
+    FOLDER_ORDER_DESC = "-folder__order"
+    ORDER_DESC = "-order"
+    TITLE_DESC = "-title"
+    UPDATED_AT_DESC = "-updated_at"
 
     def __str__(self) -> str:
         return str(self.value)

dart/generated/models/list_tasks_o_item.py

@@ -7,11 +7,11 @@ class ListTasksOItem(str, Enum):
     ORDER = "order"
     TITLE = "title"
     UPDATED_AT = "updated_at"
-    VALUE_0 = "-created_at"
-    VALUE_1 = "-dartboard__order"
-    VALUE_2 = "-order"
-    VALUE_3 = "-title"
-    VALUE_4 = "-updated_at"
+    CREATED_AT_DESC = "-created_at"
+    DARTBOARD_ORDER_DESC = "-dartboard__order"
+    ORDER_DESC = "-order"
+    TITLE_DESC = "-title"
+    UPDATED_AT_DESC = "-updated_at"
 
     def __str__(self) -> str:
         return str(self.value)