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

dart/dart.py

@@ -60,7 +60,7 @@ _PROG = "dart"
 
 _PROD_HOST = "https://app.dartai.com"
 _STAG_HOST = "https://stag.dartai.com"
-_DEV_HOST = "http://localhost:5173"
+_DEV_HOST = "http://localhost:5100"
 _HOST_MAP = {"prod": _PROD_HOST, "stag": _STAG_HOST, "dev": _DEV_HOST}
 
 # Service commands
@@ -85,6 +85,7 @@ _ROOT_PUBLIC_API_URL_FRAG = f"{_ROOT_PRIVATE_API_URL_FRAG}/public"
 _COPY_BRANCH_URL_FRAG = "/vcs/copy-branch-link"
 
 _AUTH_TOKEN_ENVVAR_KEY = "DART_TOKEN"
+_HOST_ENVVAR_KEY = "DART_HOST"
 _CONFIG_FPATH = platformdirs.user_config_path(_APP)
 _CLIENT_ID_KEY = "clientId"
 _HOST_KEY = "host"
@@ -105,6 +106,8 @@ _DEFAULT_DARTBOARD = "General/Active"
 
 _VERSION = version(_APP)
 _AUTH_TOKEN_ENVVAR = os.environ.get(_AUTH_TOKEN_ENVVAR_KEY)
+_HOST_ENVVAR = os.environ.get(_HOST_ENVVAR_KEY)
+_DEFAULT_HOST = _HOST_ENVVAR or _PROD_HOST
 
 
 def _get_help_text(fn: Callable) -> str:
@@ -221,7 +224,7 @@ class _Config:
                 pass
         self._content = {
             _CLIENT_ID_KEY: _make_id(),
-            _HOST_KEY: _PROD_HOST,
+            _HOST_KEY: _DEFAULT_HOST,
             _HOSTS_KEY: {},
         } | self._content
         self._content[_HOSTS_KEY] = defaultdict(dict, self._content[_HOSTS_KEY])
@@ -371,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:
@@ -527,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
 
@@ -560,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
 
 
@@ -598,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(
@@ -616,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
 
 
@@ -816,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/doc/list_docs.py

@@ -12,11 +12,13 @@ from ...types import UNSET, Response, Unset
 
 def _get_kwargs(
     *,
+    editor: Union[Unset, str] = UNSET,
     folder: Union[Unset, str] = UNSET,
     folder_id: Union[Unset, str] = UNSET,
     ids: Union[Unset, str] = UNSET,
     in_trash: Union[Unset, bool] = UNSET,
     limit: Union[Unset, int] = UNSET,
+    no_defaults: Union[Unset, bool] = False,
     o: Union[Unset, list[ListDocsOItem]] = UNSET,
     offset: Union[Unset, int] = UNSET,
     s: Union[Unset, str] = UNSET,
@@ -25,6 +27,8 @@ def _get_kwargs(
 ) -> dict[str, Any]:
     params: dict[str, Any] = {}
 
+    params["editor"] = editor
+
     params["folder"] = folder
 
     params["folder_id"] = folder_id
@@ -35,6 +39,8 @@ def _get_kwargs(
 
     params["limit"] = limit
 
+    params["no_defaults"] = no_defaults
+
     json_o: Union[Unset, list[str]] = UNSET
     if not isinstance(o, Unset):
         json_o = []
@@ -90,11 +96,13 @@ def _build_response(
 def sync_detailed(
     *,
     client: Union[AuthenticatedClient, Client],
+    editor: Union[Unset, str] = UNSET,
     folder: Union[Unset, str] = UNSET,
     folder_id: Union[Unset, str] = UNSET,
     ids: Union[Unset, str] = UNSET,
     in_trash: Union[Unset, bool] = UNSET,
     limit: Union[Unset, int] = UNSET,
+    no_defaults: Union[Unset, bool] = False,
     o: Union[Unset, list[ListDocsOItem]] = UNSET,
     offset: Union[Unset, int] = UNSET,
     s: Union[Unset, str] = UNSET,
@@ -105,11 +113,13 @@ def sync_detailed(
     full-text search. Sort by creation/update date or title. Supports pagination.
 
     Args:
+        editor (Union[Unset, str]):
         folder (Union[Unset, str]):
         folder_id (Union[Unset, str]):
         ids (Union[Unset, str]):
         in_trash (Union[Unset, bool]):
         limit (Union[Unset, int]):
+        no_defaults (Union[Unset, bool]):  Default: False.
         o (Union[Unset, list[ListDocsOItem]]):
         offset (Union[Unset, int]):
         s (Union[Unset, str]):
@@ -125,11 +135,13 @@ def sync_detailed(
     """
 
     kwargs = _get_kwargs(
+        editor=editor,
         folder=folder,
         folder_id=folder_id,
         ids=ids,
         in_trash=in_trash,
         limit=limit,
+        no_defaults=no_defaults,
         o=o,
         offset=offset,
         s=s,
@@ -147,11 +159,13 @@ def sync_detailed(
 def sync(
     *,
     client: Union[AuthenticatedClient, Client],
+    editor: Union[Unset, str] = UNSET,
     folder: Union[Unset, str] = UNSET,
     folder_id: Union[Unset, str] = UNSET,
     ids: Union[Unset, str] = UNSET,
     in_trash: Union[Unset, bool] = UNSET,
     limit: Union[Unset, int] = UNSET,
+    no_defaults: Union[Unset, bool] = False,
     o: Union[Unset, list[ListDocsOItem]] = UNSET,
     offset: Union[Unset, int] = UNSET,
     s: Union[Unset, str] = UNSET,
@@ -162,11 +176,13 @@ def sync(
     full-text search. Sort by creation/update date or title. Supports pagination.
 
     Args:
+        editor (Union[Unset, str]):
         folder (Union[Unset, str]):
         folder_id (Union[Unset, str]):
         ids (Union[Unset, str]):
         in_trash (Union[Unset, bool]):
         limit (Union[Unset, int]):
+        no_defaults (Union[Unset, bool]):  Default: False.
         o (Union[Unset, list[ListDocsOItem]]):
         offset (Union[Unset, int]):
         s (Union[Unset, str]):
@@ -183,11 +199,13 @@ def sync(
 
     return sync_detailed(
         client=client,
+        editor=editor,
         folder=folder,
         folder_id=folder_id,
         ids=ids,
         in_trash=in_trash,
         limit=limit,
+        no_defaults=no_defaults,
         o=o,
         offset=offset,
         s=s,
@@ -199,11 +217,13 @@ def sync(
 async def asyncio_detailed(
     *,
     client: Union[AuthenticatedClient, Client],
+    editor: Union[Unset, str] = UNSET,
     folder: Union[Unset, str] = UNSET,
     folder_id: Union[Unset, str] = UNSET,
     ids: Union[Unset, str] = UNSET,
     in_trash: Union[Unset, bool] = UNSET,
     limit: Union[Unset, int] = UNSET,
+    no_defaults: Union[Unset, bool] = False,
     o: Union[Unset, list[ListDocsOItem]] = UNSET,
     offset: Union[Unset, int] = UNSET,
     s: Union[Unset, str] = UNSET,
@@ -214,11 +234,13 @@ async def asyncio_detailed(
     full-text search. Sort by creation/update date or title. Supports pagination.
 
     Args:
+        editor (Union[Unset, str]):
         folder (Union[Unset, str]):
         folder_id (Union[Unset, str]):
         ids (Union[Unset, str]):
         in_trash (Union[Unset, bool]):
         limit (Union[Unset, int]):
+        no_defaults (Union[Unset, bool]):  Default: False.
         o (Union[Unset, list[ListDocsOItem]]):
         offset (Union[Unset, int]):
         s (Union[Unset, str]):
@@ -234,11 +256,13 @@ async def asyncio_detailed(
     """
 
     kwargs = _get_kwargs(
+        editor=editor,
         folder=folder,
         folder_id=folder_id,
         ids=ids,
         in_trash=in_trash,
         limit=limit,
+        no_defaults=no_defaults,
         o=o,
         offset=offset,
         s=s,
@@ -254,11 +278,13 @@ async def asyncio_detailed(
 async def asyncio(
     *,
     client: Union[AuthenticatedClient, Client],
+    editor: Union[Unset, str] = UNSET,
     folder: Union[Unset, str] = UNSET,
     folder_id: Union[Unset, str] = UNSET,
     ids: Union[Unset, str] = UNSET,
     in_trash: Union[Unset, bool] = UNSET,
     limit: Union[Unset, int] = UNSET,
+    no_defaults: Union[Unset, bool] = False,
     o: Union[Unset, list[ListDocsOItem]] = UNSET,
     offset: Union[Unset, int] = UNSET,
     s: Union[Unset, str] = UNSET,
@@ -269,11 +295,13 @@ async def asyncio(
     full-text search. Sort by creation/update date or title. Supports pagination.
 
     Args:
+        editor (Union[Unset, str]):
         folder (Union[Unset, str]):
         folder_id (Union[Unset, str]):
         ids (Union[Unset, str]):
         in_trash (Union[Unset, bool]):
         limit (Union[Unset, int]):
+        no_defaults (Union[Unset, bool]):  Default: False.
         o (Union[Unset, list[ListDocsOItem]]):
         offset (Union[Unset, int]):
         s (Union[Unset, str]):
@@ -291,11 +319,13 @@ async def asyncio(
     return (
         await asyncio_detailed(
             client=client,
+            editor=editor,
             folder=folder,
             folder_id=folder_id,
             ids=ids,
             in_trash=in_trash,
             limit=limit,
+            no_defaults=no_defaults,
             o=o,
             offset=offset,
             s=s,

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