dart-tools 0.5.12__tar.gz → 0.6.1__tar.gz

{dart_tools-0.5.12/dart_tools.egg-info → dart_tools-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dart-tools
-Version: 0.5.12
+Version: 0.6.1
 Summary: The Dart CLI and Python Library
 Author-email: Dart Software Team <software@itsdart.com>
 License: MIT License
@@ -166,7 +166,7 @@ task_update_op = Operation(
     data=task_update,
 )
 
-# Call the operation transactionally to preform the update
+# Call the operation transactionally to perform the update
 response = dart.transact([task_update_op], TransactionKind.TASK_UPDATE)
 ```
 

{dart_tools-0.5.12 → dart_tools-0.6.1}/README.md

@@ -105,7 +105,7 @@ task_update_op = Operation(
     data=task_update,
 )
 
-# Call the operation transactionally to preform the update
+# Call the operation transactionally to perform the update
 response = dart.transact([task_update_op], TransactionKind.TASK_UPDATE)
 ```
 

{dart_tools-0.5.12 → dart_tools-0.6.1}/dart/dart.py

@@ -3,7 +3,7 @@
 
 """A CLI to interact with the Dart web app."""
 
-import argparse
+from argparse import ArgumentParser
 from functools import wraps
 import json
 import os
@@ -16,7 +16,7 @@ import sys
 from collections import defaultdict
 from datetime import timezone
 from importlib.metadata import version
-from typing import Literal, NoReturn
+from typing import Callable, Literal, NoReturn
 from webbrowser import open_new_tab
 
 import dateparser
@@ -51,8 +51,9 @@ _APP = "dart-tools"
 _PROG = "dart"
 
 _PROD_HOST = "https://app.itsdart.com"
+_STAG_HOST = "https://stag.itsdart.com"
 _DEV_HOST = "http://localhost:5173"
-_HOST_MAP = {"prod": _PROD_HOST, "dev": _DEV_HOST}
+_HOST_MAP = {"prod": _PROD_HOST, "stag": _STAG_HOST, "dev": _DEV_HOST}
 
 _VERSION_CMD = "--version"
 _SET_HOST_CMD = "sethost"
@@ -97,11 +98,11 @@ _is_cli = False
 
 
 # TODO dedupe these functions with other usages elsewhere
-def _make_duid():
+def _make_duid() -> str:
     return "".join(random.choices(_DUID_CHARS, k=12))
 
 
-def trim_slug_str(s: str, length: int, max_under: int | None = None):
+def trim_slug_str(s: str, length: int, max_under: int | None = None) -> str:
     max_under = max_under if max_under is not None else length // 6
     if len(s) <= length:
         return s
@@ -111,26 +112,30 @@ def trim_slug_str(s: str, length: int, max_under: int | None = None):
     return s[:length]
 
 
-def slugify_str(s: str, lower=False, trim_kwargs=None):
+def slugify_str(s: str, lower: bool = False, trim_kwargs: dict = None) -> str:
     lowered = s.lower() if lower else s
     formatted = _NON_ALPHANUM_RE.sub("-", lowered.replace("'", ""))
     formatted = _REPEATED_DASH_RE.sub("-", formatted).strip("-")
-    return trim_slug_str(formatted, **trim_kwargs) if trim_kwargs is not None else formatted
+    return (
+        trim_slug_str(formatted, **trim_kwargs)
+        if trim_kwargs is not None
+        else formatted
+    )
 
 
-def _run_cmd(cmd):
+def _run_cmd(cmd: str) -> str:
     return subprocess.check_output(cmd, shell=True).decode()
 
 
-def _get_space_url(host, duid):
+def _get_space_url(host: str, duid: str) -> str:
     return f"{host}/s/{duid}"
 
 
-def _get_task_url(host, duid):
+def _get_task_url(host: str, duid: str) -> str:
     return f"{host}/t/{duid}"
 
 
-def _suppress_exception(fn):
+def _suppress_exception(fn: Callable) -> Callable:
     @wraps(fn)
     def wrapper(*args, **kwargs):
         try:
@@ -141,7 +146,7 @@ def _suppress_exception(fn):
     return wrapper
 
 
-def _dart_exit(message):
+def _dart_exit(message: str) -> NoReturn:
     if _is_cli:
         sys.exit(message)
     raise DartException(message)
@@ -151,7 +156,7 @@ def _exit_gracefully(_signal_received, _frame) -> None:
     _dart_exit("Quitting.")
 
 
-def _log(s):
+def _log(s: str) -> None:
     if not _is_cli:
         return
     print(s)
@@ -279,7 +284,7 @@ class Dart(Client):
         return transactions_create.sync(
             client=self,
             x_csrftoken=self._session.get_csrf_token(),
-            json_body=request_body,
+            body=request_body,
         )
 
 
@@ -411,7 +416,7 @@ class _Git:
         _run_cmd(f"git checkout -b {branch}")
 
 
-def set_host(host):
+def set_host(host: str) -> bool:
     config = _Config()
 
     new_host = _HOST_MAP.get(host, host)
@@ -422,7 +427,7 @@ def set_host(host):
     return True
 
 
-def _auth_failure_exit():
+def _auth_failure_exit() -> NoReturn:
     _dart_exit(f"Not logged in, run\n\n  {_PROG} {_LOGIN_CMD}\n\nto log in.")
 
 
@@ -430,7 +435,7 @@ def _unknown_failure_exit() -> NoReturn:
     _dart_exit("Unknown failure, email\n\n  support@itsdart.com\n\nfor help.")
 
 
-def _check_request_response_and_maybe_exit(response):
+def _check_request_response_and_maybe_exit(response) -> None:
     try:
         response.raise_for_status()
     except requests.exceptions.HTTPError:
@@ -457,14 +462,14 @@ def _parse_transaction_response_and_maybe_exit(
     return model
 
 
-def print_version():
+def print_version() -> str:
     result = f"dart-tools version {_VERSION}"
     _log(result)
     return result
 
 
 @_suppress_exception
-def print_version_update_message_maybe():
+def print_version_update_message_maybe() -> None:
     latest = (
         _run_cmd("pip --disable-pip-version-check index versions dart-tools 2>&1")
         .rsplit("LATEST:", maxsplit=1)[-1]
@@ -481,12 +486,12 @@ def print_version_update_message_maybe():
     )
 
 
-def _get_is_logged_in(session):
+def _get_is_logged_in(session: _Session) -> bool:
     response = session.get(_USER_STATUS_URL_FRAG)
     return response.json().get("isLoggedIn", False)
 
 
-def is_logged_in(should_raise=False):
+def is_logged_in(should_raise: bool = False) -> bool:
     config = _Config()
     session = _Session(config)
 
@@ -498,7 +503,7 @@ def is_logged_in(should_raise=False):
     return result
 
 
-def login(token=None):
+def login(token: str | None = None) -> bool:
     config = _Config()
     session = _Session(config)
 
@@ -522,7 +527,9 @@ def login(token=None):
     return True
 
 
-def _begin_task(config, session, user_email, get_task):
+def _begin_task(
+    config: _Config, session: _Session, user_email: str, get_task: Callable
+) -> bool:
     _Git.ensure_in_repo()
     _Git.ensure_no_unstaged_changes()
     _Git.ensure_on_main_or_intended()
@@ -541,7 +548,7 @@ def _begin_task(config, session, user_email, get_task):
     return True
 
 
-def begin_task():
+def begin_task() -> bool:
     config = _Config()
     session = _Session(config)
 
@@ -592,17 +599,17 @@ def begin_task():
 
 
 def create_task(
-    title,
+    title: str,
     *,
-    should_begin=False,
-    dartboard_title=None,
-    status_title=None,
-    assignee_emails=None,
-    tag_titles=None,
-    priority_int=None,
-    size_int=None,
-    due_at_str=None,
-):
+    should_begin: bool = False,
+    dartboard_title: str | None = None,
+    status_title: str | None = None,
+    assignee_emails: list[str] | None = None,
+    tag_titles: list[str] | None = None,
+    priority_int: int | None = None,
+    size_int: int | None = None,
+    due_at_str: str | None = None,
+) -> Task:
     config = _Config()
     session = _Session(config)
     dart = Dart(session)
@@ -726,17 +733,17 @@ def create_task(
 
 
 def update_task(
-    duid,
+    duid: str,
     *,
-    title=None,
-    dartboard_title=None,
-    status_title=None,
-    assignee_emails=None,
-    tag_titles=None,
-    priority_int=None,
-    size_int=None,
-    due_at_str=None,
-):
+    title: str | None = None,
+    dartboard_title: str | None = None,
+    status_title: str | None = None,
+    assignee_emails: list[str] | None = None,
+    tag_titles: list[str] | None = None,
+    priority_int: int | None = None,
+    size_int: int | None = None,
+    due_at_str: str | None = None,
+) -> Task:
     config = _Config()
     session = _Session(config)
     dart = Dart(session)
@@ -856,7 +863,7 @@ def update_task(
     return task
 
 
-def replicate_space(duid):
+def replicate_space(duid: str) -> Space:
     config = _Config()
     session = _Session(config)
 
@@ -870,7 +877,7 @@ def replicate_space(duid):
     return space
 
 
-def _add_standard_task_arguments(parser):
+def _add_standard_task_arguments(parser: ArgumentParser) -> None:
     parser.add_argument(
         "-d", "--dartboard", dest="dartboard_title", help="dartboard title"
     )
@@ -905,7 +912,7 @@ def _add_standard_task_arguments(parser):
     parser.add_argument("-r", "--duedate", dest="due_at_str", help="due date")
 
 
-def cli():
+def cli() -> None:
     signal.signal(signal.SIGINT, _exit_gracefully)
     global _is_cli
     _is_cli = True
@@ -916,9 +923,7 @@ def cli():
         print_version()
         return
 
-    parser = argparse.ArgumentParser(
-        prog=_PROG, description="A CLI to interact with Dart"
-    )
+    parser = ArgumentParser(prog=_PROG, description="A CLI to interact with Dart")
     subparsers = parser.add_subparsers(
         title="command",
         required=True,
@@ -926,7 +931,7 @@ def cli():
     )
 
     set_host_parser = subparsers.add_parser(_SET_HOST_CMD, aliases="s")
-    set_host_parser.add_argument("host", help="the new host: {prod|dev|[URL]}")
+    set_host_parser.add_argument("host", help="the new host: {prod|stag|dev|[URL]}")
     set_host_parser.set_defaults(func=set_host)
 
     login_parser = subparsers.add_parser(_LOGIN_CMD, aliases="l", help="login")

{dart_tools-0.5.12 → dart_tools-0.6.1}/dart/generated/models/__init__.py

@@ -3,11 +3,13 @@
 from .attachment import Attachment
 from .attachment_create import AttachmentCreate
 from .attachment_update import AttachmentUpdate
+from .bar_chart_adtl import BarChartAdtl
 from .brainstorm import Brainstorm
 from .brainstorm_create import BrainstormCreate
 from .brainstorm_state import BrainstormState
 from .brainstorm_update import BrainstormUpdate
-from .color_name import ColorName
+from .chart import Chart
+from .chart_type import ChartType
 from .comment import Comment
 from .comment_create import CommentCreate
 from .comment_reaction import CommentReaction
@@ -19,6 +21,9 @@ from .dartboard_create import DartboardCreate
 from .dartboard_kind import DartboardKind
 from .dartboard_update import DartboardUpdate
 from .dartboards_list_kind import DartboardsListKind
+from .dashboard import Dashboard
+from .dashboard_create import DashboardCreate
+from .dashboard_update import DashboardUpdate
 from .discord_integration import DiscordIntegration
 from .doc import Doc
 from .doc_create import DocCreate
@@ -58,11 +63,14 @@ from .layout_create import LayoutCreate
 from .layout_kind import LayoutKind
 from .layout_kind_config_map import LayoutKindConfigMap
 from .layout_update import LayoutUpdate
+from .line_chart_adtl import LineChartAdtl
 from .models_response import ModelsResponse
 from .notification import Notification
 from .notification_update import NotificationUpdate
 from .notion_integration import NotionIntegration
 from .notion_integration_tenant_extension_status import NotionIntegrationTenantExtensionStatus
+from .number_chart_adtl import NumberChartAdtl
+from .number_chart_aggregation import NumberChartAggregation
 from .operation import Operation
 from .operation_kind import OperationKind
 from .operation_model_kind import OperationModelKind
@@ -85,12 +93,15 @@ from .paginated_relationship_list import PaginatedRelationshipList
 from .paginated_space_list import PaginatedSpaceList
 from .paginated_status_list import PaginatedStatusList
 from .paginated_task_doc_relationship_list import PaginatedTaskDocRelationshipList
+from .paginated_task_kind_list import PaginatedTaskKindList
 from .paginated_task_link_list import PaginatedTaskLinkList
 from .paginated_task_list import PaginatedTaskList
 from .paginated_tenant_list import PaginatedTenantList
 from .paginated_user_dartboard_layout_list import PaginatedUserDartboardLayoutList
 from .paginated_user_list import PaginatedUserList
 from .paginated_view_list import PaginatedViewList
+from .pie_chart_adtl import PieChartAdtl
+from .pie_chart_display_metric import PieChartDisplayMetric
 from .priority import Priority
 from .properties_list_kind import PropertiesListKind
 from .property_ import Property
@@ -122,12 +133,16 @@ from .statuses_list_kind import StatusesListKind
 from .subscription import Subscription
 from .subtask_display_mode import SubtaskDisplayMode
 from .summary_statistic_kind import SummaryStatisticKind
+from .table_chart_adtl import TableChartAdtl
 from .task import Task
 from .task_create import TaskCreate
 from .task_detail_mode import TaskDetailMode
 from .task_doc_relationship import TaskDocRelationship
 from .task_doc_relationship_create import TaskDocRelationshipCreate
 from .task_kind import TaskKind
+from .task_kind_create import TaskKindCreate
+from .task_kind_kind import TaskKindKind
+from .task_kind_update import TaskKindUpdate
 from .task_link import TaskLink
 from .task_link_create import TaskLinkCreate
 from .task_link_kind import TaskLinkKind
@@ -164,11 +179,13 @@ __all__ = (
     "Attachment",
     "AttachmentCreate",
     "AttachmentUpdate",
+    "BarChartAdtl",
     "Brainstorm",
     "BrainstormCreate",
     "BrainstormState",
     "BrainstormUpdate",
-    "ColorName",
+    "Chart",
+    "ChartType",
     "Comment",
     "CommentCreate",
     "CommentReaction",
@@ -180,6 +197,9 @@ __all__ = (
     "DartboardKind",
     "DartboardsListKind",
     "DartboardUpdate",
+    "Dashboard",
+    "DashboardCreate",
+    "DashboardUpdate",
     "DiscordIntegration",
     "Doc",
     "DocCreate",
@@ -219,11 +239,14 @@ __all__ = (
     "LayoutKind",
     "LayoutKindConfigMap",
     "LayoutUpdate",
+    "LineChartAdtl",
     "ModelsResponse",
     "Notification",
     "NotificationUpdate",
     "NotionIntegration",
     "NotionIntegrationTenantExtensionStatus",
+    "NumberChartAdtl",
+    "NumberChartAggregation",
     "Operation",
     "OperationKind",
     "OperationModelKind",
@@ -246,12 +269,15 @@ __all__ = (
     "PaginatedSpaceList",
     "PaginatedStatusList",
     "PaginatedTaskDocRelationshipList",
+    "PaginatedTaskKindList",
     "PaginatedTaskLinkList",
     "PaginatedTaskList",
     "PaginatedTenantList",
     "PaginatedUserDartboardLayoutList",
     "PaginatedUserList",
     "PaginatedViewList",
+    "PieChartAdtl",
+    "PieChartDisplayMetric",
     "Priority",
     "PropertiesListKind",
     "Property",
@@ -283,12 +309,16 @@ __all__ = (
     "Subscription",
     "SubtaskDisplayMode",
     "SummaryStatisticKind",
+    "TableChartAdtl",
     "Task",
     "TaskCreate",
     "TaskDetailMode",
     "TaskDocRelationship",
     "TaskDocRelationshipCreate",
     "TaskKind",
+    "TaskKindCreate",
+    "TaskKindKind",
+    "TaskKindUpdate",
     "TaskLink",
     "TaskLinkCreate",
     "TaskLinkKind",

{dart_tools-0.5.12 → dart_tools-0.6.1}/dart/generated/models/attachment.py

@@ -3,8 +3,6 @@ from typing import Any, Dict, List, Type, TypeVar, Union, cast
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 
-from ..models.color_name import ColorName
-
 T = TypeVar("T", bound="Attachment")
 
 
@@ -18,30 +16,6 @@ class Attachment:
         kind (str):
         file_url (str):
         color_hex (str):
-        color_name (ColorName): * `Red` - RED
-            * `Dark Blue` - DARK_BLUE
-            * `Dark Orange` - DARK_ORANGE
-            * `Dark Green` - DARK_GREEN
-            * `Purple` - PURPLE
-            * `Dark Teal` - DARK_TEAL
-            * `Pink` - PINK
-            * `Orange` - ORANGE
-            * `Green` - GREEN
-            * `Yellow` - YELLOW
-            * `Brown` - BROWN
-            * `Dark Red` - DARK_RED
-            * `Flat Green` - FLAT_GREEN
-            * `Red Orange` - RED_ORANGE
-            * `Teal` - TEAL
-            * `Light Green` - LIGHT_GREEN
-            * `Light Blue` - LIGHT_BLUE
-            * `Light Purple` - LIGHT_PURPLE
-            * `Light Orange` - LIGHT_ORANGE
-            * `Light Pink` - LIGHT_PINK
-            * `Tan` - TAN
-            * `Dark Gray` - DARK_GRAY
-            * `Light Brown` - LIGHT_BROWN
-            * `Light Gray` - LIGHT_GRAY
         recommendation_duid (Union[None, str]):
     """
 
@@ -51,7 +25,6 @@ class Attachment:
     kind: str
     file_url: str
     color_hex: str
-    color_name: ColorName
     recommendation_duid: Union[None, str]
     additional_properties: Dict[str, Any] = _attrs_field(init=False, factory=dict)
 
@@ -68,8 +41,6 @@ class Attachment:
 
         color_hex = self.color_hex
 
-        color_name = self.color_name.value
-
         recommendation_duid: Union[None, str]
         recommendation_duid = self.recommendation_duid
 
@@ -83,7 +54,6 @@ class Attachment:
                 "kind": kind,
                 "fileUrl": file_url,
                 "colorHex": color_hex,
-                "colorName": color_name,
                 "recommendationDuid": recommendation_duid,
             }
         )
@@ -105,8 +75,6 @@ class Attachment:
 
         color_hex = d.pop("colorHex")
 
-        color_name = ColorName(d.pop("colorName"))
-
         def _parse_recommendation_duid(data: object) -> Union[None, str]:
             if data is None:
                 return data
@@ -121,7 +89,6 @@ class Attachment:
             kind=kind,
             file_url=file_url,
             color_hex=color_hex,
-            color_name=color_name,
             recommendation_duid=recommendation_duid,
         )
 

{dart_tools-0.5.12 → dart_tools-0.6.1}/dart/generated/models/attachment_create.py

@@ -3,7 +3,6 @@ from typing import Any, Dict, List, Type, TypeVar, Union, cast
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 
-from ..models.color_name import ColorName
 from ..types import UNSET, Unset
 
 T = TypeVar("T", bound="AttachmentCreate")
@@ -19,30 +18,6 @@ class AttachmentCreate:
         kind (str):
         file_path (str):
         color_hex (Union[Unset, str]):
-        color_name (Union[Unset, ColorName]): * `Red` - RED
-            * `Dark Blue` - DARK_BLUE
-            * `Dark Orange` - DARK_ORANGE
-            * `Dark Green` - DARK_GREEN
-            * `Purple` - PURPLE
-            * `Dark Teal` - DARK_TEAL
-            * `Pink` - PINK
-            * `Orange` - ORANGE
-            * `Green` - GREEN
-            * `Yellow` - YELLOW
-            * `Brown` - BROWN
-            * `Dark Red` - DARK_RED
-            * `Flat Green` - FLAT_GREEN
-            * `Red Orange` - RED_ORANGE
-            * `Teal` - TEAL
-            * `Light Green` - LIGHT_GREEN
-            * `Light Blue` - LIGHT_BLUE
-            * `Light Purple` - LIGHT_PURPLE
-            * `Light Orange` - LIGHT_ORANGE
-            * `Light Pink` - LIGHT_PINK
-            * `Tan` - TAN
-            * `Dark Gray` - DARK_GRAY
-            * `Light Brown` - LIGHT_BROWN
-            * `Light Gray` - LIGHT_GRAY
         recommendation_duid (Union[None, Unset, str]):
     """
 
@@ -52,7 +27,6 @@ class AttachmentCreate:
     kind: str
     file_path: str
     color_hex: Union[Unset, str] = UNSET
-    color_name: Union[Unset, ColorName] = UNSET
     recommendation_duid: Union[None, Unset, str] = UNSET
     additional_properties: Dict[str, Any] = _attrs_field(init=False, factory=dict)
 
@@ -69,10 +43,6 @@ class AttachmentCreate:
 
         color_hex = self.color_hex
 
-        color_name: Union[Unset, str] = UNSET
-        if not isinstance(self.color_name, Unset):
-            color_name = self.color_name.value
-
         recommendation_duid: Union[None, Unset, str]
         if isinstance(self.recommendation_duid, Unset):
             recommendation_duid = UNSET
@@ -92,8 +62,6 @@ class AttachmentCreate:
         )
         if color_hex is not UNSET:
             field_dict["colorHex"] = color_hex
-        if color_name is not UNSET:
-            field_dict["colorName"] = color_name
         if recommendation_duid is not UNSET:
             field_dict["recommendationDuid"] = recommendation_duid
 
@@ -114,13 +82,6 @@ class AttachmentCreate:
 
         color_hex = d.pop("colorHex", UNSET)
 
-        _color_name = d.pop("colorName", UNSET)
-        color_name: Union[Unset, ColorName]
-        if isinstance(_color_name, Unset):
-            color_name = UNSET
-        else:
-            color_name = ColorName(_color_name)
-
         def _parse_recommendation_duid(data: object) -> Union[None, Unset, str]:
             if data is None:
                 return data
@@ -137,7 +98,6 @@ class AttachmentCreate:
             kind=kind,
             file_path=file_path,
             color_hex=color_hex,
-            color_name=color_name,
             recommendation_duid=recommendation_duid,
         )