dart-tools 0.4.7__tar.gz → 0.4.8__tar.gz

{dart-tools-0.4.7/dart_tools.egg-info → dart-tools-0.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dart-tools
-Version: 0.4.7
+Version: 0.4.8
 Summary: The Dart CLI and Python Library
 Author-email: Dart Software Team <software@itsdart.com>
 License: MIT License
@@ -106,17 +106,17 @@ In Python, you can run something like
 import os
 from dart import is_logged_in, login, create_task, update_task
 
-# login based on information stored in environment variables, but only if needed
+# Login based on information stored in environment variables, but only if needed
 if not is_logged_in():
     login(email=os.environ["DART_EMAIL"], password=os.environ["DART_PASSWORD"])
 
-# create a new task called 'Update the landing page'
-# with priority 'Critical' (i.e. p0) and with the 'marketing' tag
+# Create a new task called 'Update the landing page'
+# With priority 'Critical' (i.e. p0) and with the 'marketing' tag
 new_task = create_task(
     "Update the landing page", priority_int=0, tag_titles=["marketing"]
 )
 
-# update the task to be 'Done'
+# Update the task to be 'Done'
 update_task(new_task.duid, status_title="Done")
 ```
 
@@ -140,10 +140,10 @@ from dart import (
     TransactionKind,
 )
 
-# initialize the inner client
+# Initialize the inner client
 dart = Dart()
 
-# prepare the update operation
+# Prepare the update operation
 task_update = TaskUpdate(
     duid="[DUID]",
     size=5,
@@ -154,7 +154,7 @@ task_update_op = Operation(
     data=task_update,
 )
 
-# call the operation transactionally to preform the update
+# Call the operation transactionally to preform the update
 response = dart.transact([task_update_op], TransactionKind.TASK_UPDATE)
 ```
 

{dart-tools-0.4.7 → dart-tools-0.4.8}/README.md

@@ -49,17 +49,17 @@ In Python, you can run something like
 import os
 from dart import is_logged_in, login, create_task, update_task
 
-# login based on information stored in environment variables, but only if needed
+# Login based on information stored in environment variables, but only if needed
 if not is_logged_in():
     login(email=os.environ["DART_EMAIL"], password=os.environ["DART_PASSWORD"])
 
-# create a new task called 'Update the landing page'
-# with priority 'Critical' (i.e. p0) and with the 'marketing' tag
+# Create a new task called 'Update the landing page'
+# With priority 'Critical' (i.e. p0) and with the 'marketing' tag
 new_task = create_task(
     "Update the landing page", priority_int=0, tag_titles=["marketing"]
 )
 
-# update the task to be 'Done'
+# Update the task to be 'Done'
 update_task(new_task.duid, status_title="Done")
 ```
 
@@ -83,10 +83,10 @@ from dart import (
     TransactionKind,
 )
 
-# initialize the inner client
+# Initialize the inner client
 dart = Dart()
 
-# prepare the update operation
+# Prepare the update operation
 task_update = TaskUpdate(
     duid="[DUID]",
     size=5,
@@ -97,7 +97,7 @@ task_update_op = Operation(
     data=task_update,
 )
 
-# call the operation transactionally to preform the update
+# Call the operation transactionally to preform the update
 response = dart.transact([task_update_op], TransactionKind.TASK_UPDATE)
 ```
 

{dart-tools-0.4.7 → dart-tools-0.4.8}/dart/__init__.py

@@ -8,4 +8,6 @@ from .dart import (
     create_task,
     update_task,
     begin_task,
+    replicate_space,
 )
+from .webhook import is_signature_correct

{dart-tools-0.4.7 → dart-tools-0.4.8}/dart/dart.py

@@ -23,6 +23,7 @@ import dateparser
 from pick import pick
 import requests
 
+from .exception import DartException
 from .generated import Client
 from .generated.models import (
     DartboardKind,
@@ -32,6 +33,7 @@ from .generated.models import (
     Priority,
     PropertyKind,
     RequestBody,
+    Space,
     SpaceKind,
     StatusKind,
     Task,
@@ -62,6 +64,7 @@ _CSRF_URL_FRAG = _ROOT_API_URL_FRAG + "/csrf-token"
 _LOGIN_URL_FRAG = _ROOT_API_URL_FRAG + "/login"
 _CURRENT_USER_URL_FRAG = _ROOT_API_URL_FRAG + "/user-data?mode=auto"
 _COPY_BRANCH_URL_FRAG = _ROOT_API_URL_FRAG + "/vcs/copy-branch-link"
+_REPLICATE_SPACE_URL_FRAG_FMT = _ROOT_API_URL_FRAG + "/spaces/replicate/{duid}"
 
 _CONFIG_FPATH = os.path.expanduser("~/.dart-tools")
 _CSRF_TOKEN_COOKIE = "csrftoken"
@@ -96,6 +99,10 @@ def _run_cmd(cmd):
     return subprocess.check_output(cmd, shell=True).decode()
 
 
+def _get_space_url(host, duid):
+    return f"{host}/s/{duid}"
+
+
 def _get_task_url(host, duid):
     return f"{host}/t/{duid}"
 
@@ -111,8 +118,14 @@ def _suppress_exception(fn):
     return wrapper
 
 
+def _dart_exit(message):
+    if _is_cli:
+        sys.exit(message)
+    raise DartException(message)
+
+
 def _exit_gracefully(_signal_received, _frame) -> None:
-    sys.exit("Quitting.")
+    _dart_exit("Quitting.")
 
 
 def _log(s):
@@ -343,13 +356,13 @@ class _Git:
     def ensure_in_repo():
         if _Git._cmd_succeeds("git rev-parse --is-inside-work-tree"):
             return
-        sys.exit("You are not in a git repo.")
+        _dart_exit("You are not in a git repo.")
 
     @staticmethod
     def ensure_no_unstaged_changes():
         if _run_cmd("git status --porcelain") == "":
             return
-        sys.exit("You have uncommitted changes. Please commit or stash them.")
+        _dart_exit("You have uncommitted changes. Please commit or stash them.")
 
     @staticmethod
     def ensure_on_main_or_intended():
@@ -396,11 +409,11 @@ def set_host(host):
 
 
 def _auth_failure_exit():
-    sys.exit(f"Not logged in, run\n\n{_PROG} {_LOGIN_CMD}\n\nto log in.")
+    _dart_exit(f"Not logged in, run\n\n{_PROG} {_LOGIN_CMD}\n\nto log in.")
 
 
 def _unknown_failure_exit() -> NoReturn:
-    sys.exit(f"Not logged in, run\n\n{_PROG} {_LOGIN_CMD}\n\nto log in.")
+    _dart_exit(f"Not logged in, run\n\n{_PROG} {_LOGIN_CMD}\n\nto log in.")
 
 
 def _check_request_response_and_maybe_exit(response):
@@ -475,7 +488,7 @@ def login(*, email=None, password=None):
 
     result = session.post(_LOGIN_URL_FRAG, json={"email": email, "password": password})
     if result.status_code in {401, 403}:
-        sys.exit("Invalid login information.")
+        _dart_exit("Invalid login information.")
     _check_request_response_and_maybe_exit(result)
 
     cookies = result.cookies.get_dict()
@@ -538,7 +551,7 @@ def begin_task():
         filtered_tasks.sort(key=lambda e: e["order"])
 
         if len(filtered_tasks) == 0:
-            sys.exit("No active, incomplete tasks found.")
+            _dart_exit("No active, incomplete tasks found.")
 
         picked_idx = pick(
             [e["title"] for e in filtered_tasks],
@@ -587,7 +600,7 @@ def create_task(
             None,
         )
         if dartboard is None:
-            sys.exit(f"No dartboard found with title '{dartboard_title}'.")
+            _dart_exit(f"No dartboard found with title '{dartboard_title}'.")
     else:
         dartboard = next(e for e in dartboards if e["kind"] == DartboardKind.ACTIVE)
     dartboard_duid = dartboard["duid"]
@@ -605,7 +618,7 @@ def create_task(
             (e for e in statuses if e["title"].lower() == status_title_norm), None
         )
         if status is None:
-            sys.exit(f"No status found with title '{status_title}'.")
+            _dart_exit(f"No status found with title '{status_title}'.")
     else:
         status = next(
             e for e in statuses if e["kind"] == StatusKind.UNSTARTED and e["locked"]
@@ -620,7 +633,7 @@ def create_task(
         for assignee_email in assignee_emails:
             assignee_email_norm = assignee_email.strip().lower()
             if assignee_email_norm not in user_emails_to_duids:
-                sys.exit(f"No user found with email '{assignee_email}'.")
+                _dart_exit(f"No user found with email '{assignee_email}'.")
             assignee_duids.append(user_emails_to_duids[assignee_email_norm])
             subscriber_duids.append(user_emails_to_duids[assignee_email_norm])
     else:
@@ -636,7 +649,7 @@ def create_task(
         for tag_title in tag_titles:
             tag_title_norm = tag_title.strip().lower()
             if tag_title_norm not in tag_titles_to_duids:
-                sys.exit(f"No tag found with title '{tag_title}'.")
+                _dart_exit(f"No tag found with title '{tag_title}'.")
             tag_duids.append(tag_titles_to_duids[tag_title_norm])
 
     priority = None
@@ -649,7 +662,7 @@ def create_task(
     if due_at_str is not None:
         due_at = dateparser.parse(due_at_str)
         if due_at is None:
-            sys.exit(f"Could not parse due date '{due_at_str}'.")
+            _dart_exit(f"Could not parse due date '{due_at_str}'.")
         due_at = due_at.replace(
             hour=9, minute=0, second=0, microsecond=0, tzinfo=timezone.utc
         )
@@ -712,7 +725,7 @@ def update_task(
     tasks = user_bundle.tasks
     old_task = next((e for e in tasks if e["duid"] == duid), None)
     if old_task is None:
-        sys.exit(f"No task found with DUID '{duid}'.")
+        _dart_exit(f"No task found with DUID '{duid}'.")
 
     task_update_kwargs = {"duid": duid}
 
@@ -731,7 +744,7 @@ def update_task(
             None,
         )
         if dartboard is None:
-            sys.exit(f"No dartboard found with title '{dartboard_title}'.")
+            _dart_exit(f"No dartboard found with title '{dartboard_title}'.")
         dartboard_duid = dartboard["duid"]
         if dartboard_duid != old_task["dartboardDuid"]:
             task_update_kwargs["dartboard_duid"] = dartboard_duid
@@ -743,7 +756,7 @@ def update_task(
             (e for e in statuses if e["title"].lower() == status_title_norm), None
         )
         if status is None:
-            sys.exit(f"No status found with title '{status_title}'.")
+            _dart_exit(f"No status found with title '{status_title}'.")
         status_duid = status["duid"]
         if status_duid != old_task["statusDuid"]:
             task_update_kwargs["status_duid"] = status_duid
@@ -756,7 +769,7 @@ def update_task(
         for assignee_email in assignee_emails:
             assignee_email_norm = assignee_email.strip().lower()
             if assignee_email_norm not in user_emails_to_duids:
-                sys.exit(f"No user found with email '{assignee_email}'.")
+                _dart_exit(f"No user found with email '{assignee_email}'.")
             assignee_duids.append(user_emails_to_duids[assignee_email_norm])
             subscriber_duids.append(user_emails_to_duids[assignee_email_norm])
         assignee_duids = sorted(set(assignee_duids))
@@ -777,7 +790,7 @@ def update_task(
         for tag_title in tag_titles:
             tag_title_norm = tag_title.strip().lower()
             if tag_title_norm not in tag_titles_to_duids:
-                sys.exit(f"No tag found with title '{tag_title}'.")
+                _dart_exit(f"No tag found with title '{tag_title}'.")
             tag_duids.append(tag_titles_to_duids[tag_title_norm])
         task_update_kwargs["tag_duids"] = tag_duids
 
@@ -795,7 +808,7 @@ def update_task(
     if due_at_str is not None:
         due_at = dateparser.parse(due_at_str)
         if due_at is None:
-            sys.exit(f"Could not parse due date '{due_at_str}'.")
+            _dart_exit(f"Could not parse due date '{due_at_str}'.")
         due_at = due_at.replace(
             hour=9, minute=0, second=0, microsecond=0, tzinfo=timezone.utc
         )
@@ -819,6 +832,21 @@ def update_task(
     return task
 
 
+def replicate_space(duid):
+    config = _Config()
+    session = _Session(config)
+
+    response = session.post(_REPLICATE_SPACE_URL_FRAG_FMT.format(duid=duid))
+    print()
+    _check_request_response_and_maybe_exit(response)
+
+    space = Space.from_dict(response.json()["item"])
+
+    _log(f"Replicated space {space.title} at {_get_space_url(config.host, space.duid)}")
+    _log("Done.")
+    return space
+
+
 def _add_standard_task_arguments(parser):
     parser.add_argument(
         "-d", "--dartboard", dest="dartboard_title", help="dartboard title"

dart-tools-0.4.8/dart/exception.py

@@ -0,0 +1,6 @@
+class DartException(Exception):
+    pass
+
+
+class OrderException(Exception):
+    pass

{dart-tools-0.4.7 → dart-tools-0.4.8}/dart/generated/models/__init__.py

@@ -44,6 +44,15 @@ from .folder import Folder
 from .folder_create import FolderCreate
 from .folder_kind import FolderKind
 from .folder_update import FolderUpdate
+from .form import Form
+from .form_create import FormCreate
+from .form_field import FormField
+from .form_field_create import FormFieldCreate
+from .form_field_create_default import FormFieldCreateDefault
+from .form_field_default import FormFieldDefault
+from .form_field_update import FormFieldUpdate
+from .form_field_update_default import FormFieldUpdateDefault
+from .form_update import FormUpdate
 from .github_integration import GithubIntegration
 from .github_integration_tenant_extension_status import GithubIntegrationTenantExtensionStatus
 from .google_data import GoogleData
@@ -107,6 +116,7 @@ from .task_attachment_create import TaskAttachmentCreate
 from .task_attachment_update import TaskAttachmentUpdate
 from .task_create import TaskCreate
 from .task_create_description import TaskCreateDescription
+from .task_create_properties import TaskCreateProperties
 from .task_create_recurrence import TaskCreateRecurrence
 from .task_description import TaskDescription
 from .task_doc_relationship import TaskDocRelationship
@@ -126,6 +136,7 @@ from .task_recurrence import TaskRecurrence
 from .task_source_type import TaskSourceType
 from .task_update import TaskUpdate
 from .task_update_description import TaskUpdateDescription
+from .task_update_properties import TaskUpdateProperties
 from .task_update_recurrence import TaskUpdateRecurrence
 from .tenant import Tenant
 from .tenant_create import TenantCreate
@@ -140,6 +151,7 @@ from .user_create import UserCreate
 from .user_dartboard_layout import UserDartboardLayout
 from .user_dartboard_layout_create import UserDartboardLayoutCreate
 from .user_dartboard_layout_update import UserDartboardLayoutUpdate
+from .user_role import UserRole
 from .user_status import UserStatus
 from .user_update import UserUpdate
 from .validation_error_response import ValidationErrorResponse
@@ -195,6 +207,15 @@ __all__ = (
     "FolderCreate",
     "FolderKind",
     "FolderUpdate",
+    "Form",
+    "FormCreate",
+    "FormField",
+    "FormFieldCreate",
+    "FormFieldCreateDefault",
+    "FormFieldDefault",
+    "FormFieldUpdate",
+    "FormFieldUpdateDefault",
+    "FormUpdate",
     "GithubIntegration",
     "GithubIntegrationTenantExtensionStatus",
     "GoogleData",
@@ -258,6 +279,7 @@ __all__ = (
     "TaskAttachmentUpdate",
     "TaskCreate",
     "TaskCreateDescription",
+    "TaskCreateProperties",
     "TaskCreateRecurrence",
     "TaskDescription",
     "TaskDocRelationship",
@@ -277,6 +299,7 @@ __all__ = (
     "TaskSourceType",
     "TaskUpdate",
     "TaskUpdateDescription",
+    "TaskUpdateProperties",
     "TaskUpdateRecurrence",
     "Tenant",
     "TenantCreate",
@@ -291,6 +314,7 @@ __all__ = (
     "UserDartboardLayout",
     "UserDartboardLayoutCreate",
     "UserDartboardLayoutUpdate",
+    "UserRole",
     "UserStatus",
     "UserUpdate",
     "ValidationErrorResponse",

{dart-tools-0.4.7 → dart-tools-0.4.8}/dart/generated/models/comment.py

@@ -20,6 +20,7 @@ class Comment:
     """
     Attributes:
         duid (str):
+        created_at (datetime.datetime):
         updated_at (datetime.datetime):
         task_duid (str):
         authored_by_ai (bool):
@@ -34,6 +35,7 @@ class Comment:
     """
 
     duid: str
+    created_at: datetime.datetime
     updated_at: datetime.datetime
     task_duid: str
     authored_by_ai: bool
@@ -49,6 +51,8 @@ class Comment:
 
     def to_dict(self) -> Dict[str, Any]:
         duid = self.duid
+        created_at = self.created_at.isoformat()
+
         updated_at = self.updated_at.isoformat()
 
         task_duid = self.task_duid
@@ -73,6 +77,7 @@ class Comment:
         field_dict.update(
             {
                 "duid": duid,
+                "createdAt": created_at,
                 "updatedAt": updated_at,
                 "taskDuid": task_duid,
                 "authoredByAi": authored_by_ai,
@@ -98,6 +103,8 @@ class Comment:
         d = src_dict.copy()
         duid = d.pop("duid")
 
+        created_at = isoparse(d.pop("createdAt"))
+
         updated_at = isoparse(d.pop("updatedAt"))
 
         task_duid = d.pop("taskDuid")
@@ -132,6 +139,7 @@ class Comment:
 
         comment = cls(
             duid=duid,
+            created_at=created_at,
             updated_at=updated_at,
             task_duid=task_duid,
             authored_by_ai=authored_by_ai,

dart-tools-0.4.8/dart/generated/models/form.py

@@ -0,0 +1,153 @@
+from typing import Any, Dict, List, Type, TypeVar, Union
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.color_name import ColorName
+from ..models.icon_kind import IconKind
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="Form")
+
+
+@_attrs_define
+class Form:
+    """
+    Attributes:
+        duid (str):
+        hidden (bool):
+        public (bool):
+        order (str):
+        title (str):
+        description (str):
+        icon_kind (IconKind): * `None` - NONE
+            * `Icon` - ICON
+            * `Emoji` - EMOJI
+        icon_name_or_emoji (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
+        updated_by_client_duid (Union[Unset, None, str]):
+    """
+
+    duid: str
+    hidden: bool
+    public: bool
+    order: str
+    title: str
+    description: str
+    icon_kind: IconKind
+    icon_name_or_emoji: str
+    color_name: ColorName
+    updated_by_client_duid: Union[Unset, None, str] = UNSET
+    additional_properties: Dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> Dict[str, Any]:
+        duid = self.duid
+        hidden = self.hidden
+        public = self.public
+        order = self.order
+        title = self.title
+        description = self.description
+        icon_kind = self.icon_kind.value
+
+        icon_name_or_emoji = self.icon_name_or_emoji
+        color_name = self.color_name.value
+
+        updated_by_client_duid = self.updated_by_client_duid
+
+        field_dict: Dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "duid": duid,
+                "hidden": hidden,
+                "public": public,
+                "order": order,
+                "title": title,
+                "description": description,
+                "iconKind": icon_kind,
+                "iconNameOrEmoji": icon_name_or_emoji,
+                "colorName": color_name,
+            }
+        )
+        if updated_by_client_duid is not UNSET:
+            field_dict["updatedByClientDuid"] = updated_by_client_duid
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: Type[T], src_dict: Dict[str, Any]) -> T:
+        d = src_dict.copy()
+        duid = d.pop("duid")
+
+        hidden = d.pop("hidden")
+
+        public = d.pop("public")
+
+        order = d.pop("order")
+
+        title = d.pop("title")
+
+        description = d.pop("description")
+
+        icon_kind = IconKind(d.pop("iconKind"))
+
+        icon_name_or_emoji = d.pop("iconNameOrEmoji")
+
+        color_name = ColorName(d.pop("colorName"))
+
+        updated_by_client_duid = d.pop("updatedByClientDuid", UNSET)
+
+        form = cls(
+            duid=duid,
+            hidden=hidden,
+            public=public,
+            order=order,
+            title=title,
+            description=description,
+            icon_kind=icon_kind,
+            icon_name_or_emoji=icon_name_or_emoji,
+            color_name=color_name,
+            updated_by_client_duid=updated_by_client_duid,
+        )
+
+        form.additional_properties = d
+        return form
+
+    @property
+    def additional_keys(self) -> List[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> 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