dart-tools 0.5.4__tar.gz → 0.5.6__tar.gz

{dart-tools-0.5.4 → dart_tools-0.5.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dart-tools
-Version: 0.5.4
+Version: 0.5.6
 Summary: The Dart CLI and Python Library
 Author-email: Dart Software Team <software@itsdart.com>
 License: MIT License
@@ -73,6 +73,13 @@ Requires-Dist: platformdirs
 `dart-tools` is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python.
 
 
+- [Setup](#setup)
+- [Using the CLI](#using-the-cli)
+- [Using the Python Library](#using-the-python-library)
+- [Advanced Usage](#advanced-usage)
+- [Help and Resources](#help-and-resources)
+
+
 ## Setup
 
 In the terminal, install by running

{dart-tools-0.5.4 → dart_tools-0.5.6}/README.md

@@ -12,6 +12,13 @@
 `dart-tools` is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python.
 
 
+- [Setup](#setup)
+- [Using the CLI](#using-the-cli)
+- [Using the Python Library](#using-the-python-library)
+- [Advanced Usage](#advanced-usage)
+- [Help and Resources](#help-and-resources)
+
+
 ## Setup
 
 In the terminal, install by running

{dart-tools-0.5.4 → dart_tools-0.5.6}/dart/dart.py

@@ -79,6 +79,8 @@ _AUTH_TOKEN_KEY = "authToken"
 _CSRF_TOKEN_KEY = "csrfToken"
 
 _DUID_CHARS = string.ascii_lowercase + string.ascii_uppercase + string.digits
+_NON_ALPHANUM_RE = re.compile(r"[^a-zA-Z0-9-]+")
+_REPEATED_DASH_RE = re.compile(r"-{2,}")
 _PRIORITY_MAP = {
     0: Priority.CRITICAL,
     1: Priority.HIGH,
@@ -99,6 +101,23 @@ def _make_duid():
     return "".join(random.choices(_DUID_CHARS, k=12))
 
 
+def trim_slug_str(s: str, length: int, max_under: int | None = None):
+    max_under = max_under if max_under is not None else length // 6
+    if len(s) <= length:
+        return s
+    for i in range(1, max_under + 1):
+        if s[length - i] == "-":
+            return s[: length - i]
+    return s[:length]
+
+
+def slugify_str(s: str, lower=False, trim_kwargs=None):
+    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
+
+
 def _run_cmd(cmd):
     return subprocess.check_output(cmd, shell=True).decode()
 
@@ -337,23 +356,11 @@ class _Git:
             raise ex
         return True
 
-    @staticmethod
-    def _format_for_branch(s):
-        return re.sub(
-            r"-{2,}", "-", re.sub(r"[^a-z0-9-]+", "-", s.lower().replace("'", ""))
-        ).strip("-")
-
     @staticmethod
     def make_task_name(email, task):
-        username = _Git._format_for_branch(email.split("@")[0])
-        title = _Git._format_for_branch(task.title)
-        long = f"{username}/{task.duid}-{title}"
-        if len(long) <= 60:
-            return long
-        for i in range(1, 11):
-            if long[60 - i] == "-":
-                return long[: 60 - i]
-        return long[:60]
+        username = slugify_str(email.split("@")[0], lower=True)
+        title = slugify_str(task.title, lower=True)
+        return trim_slug_str(f"{username}/{task.duid}-{title}", length=60)
 
     @staticmethod
     def get_current_branch():

{dart-tools-0.5.4 → dart_tools-0.5.6}/dart/generated/models/__init__.py

@@ -159,6 +159,7 @@ from .view_create import ViewCreate
 from .view_kind import ViewKind
 from .view_update import ViewUpdate
 from .yc_integration import YcIntegration
+from .zapier_integration import ZapierIntegration
 
 __all__ = (
     "Attachment",
@@ -320,4 +321,5 @@ __all__ = (
     "ViewKind",
     "ViewUpdate",
     "YcIntegration",
+    "ZapierIntegration",
 )

{dart-tools-0.5.4 → dart_tools-0.5.6}/dart/generated/models/dartboard.py

@@ -1,5 +1,5 @@
 import datetime
-from typing import TYPE_CHECKING, Any, Dict, List, Optional, Type, TypeVar, Union
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Type, TypeVar, Union, cast
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
@@ -61,6 +61,8 @@ class Dartboard:
             * `Light Brown` - LIGHT_BROWN
             * `Light Gray` - LIGHT_GRAY
         user_duids_to_layout_duids (List['UserDartboardLayout']):
+        always_shown_property_duids (List[str]):
+        always_hidden_property_duids (List[str]):
         updated_by_client_duid (Union[Unset, None, str]):
         index (Optional[int]):
         started_at (Optional[datetime.datetime]):
@@ -77,6 +79,8 @@ class Dartboard:
     icon_name_or_emoji: str
     color_name: ColorName
     user_duids_to_layout_duids: List["UserDartboardLayout"]
+    always_shown_property_duids: List[str]
+    always_hidden_property_duids: List[str]
     index: Optional[int]
     started_at: Optional[datetime.datetime]
     finished_at: Optional[datetime.datetime]
@@ -102,6 +106,10 @@ class Dartboard:
 
             user_duids_to_layout_duids.append(user_duids_to_layout_duids_item)
 
+        always_shown_property_duids = self.always_shown_property_duids
+
+        always_hidden_property_duids = self.always_hidden_property_duids
+
         updated_by_client_duid = self.updated_by_client_duid
         index = self.index
         started_at = self.started_at.isoformat() if self.started_at else None
@@ -122,6 +130,8 @@ class Dartboard:
                 "iconNameOrEmoji": icon_name_or_emoji,
                 "colorName": color_name,
                 "userDuidsToLayoutDuids": user_duids_to_layout_duids,
+                "alwaysShownPropertyDuids": always_shown_property_duids,
+                "alwaysHiddenPropertyDuids": always_hidden_property_duids,
                 "index": index,
                 "startedAt": started_at,
                 "finishedAt": finished_at,
@@ -162,6 +172,10 @@ class Dartboard:
 
             user_duids_to_layout_duids.append(user_duids_to_layout_duids_item)
 
+        always_shown_property_duids = cast(List[str], d.pop("alwaysShownPropertyDuids"))
+
+        always_hidden_property_duids = cast(List[str], d.pop("alwaysHiddenPropertyDuids"))
+
         updated_by_client_duid = d.pop("updatedByClientDuid", UNSET)
 
         index = d.pop("index")
@@ -191,6 +205,8 @@ class Dartboard:
             icon_name_or_emoji=icon_name_or_emoji,
             color_name=color_name,
             user_duids_to_layout_duids=user_duids_to_layout_duids,
+            always_shown_property_duids=always_shown_property_duids,
+            always_hidden_property_duids=always_hidden_property_duids,
             updated_by_client_duid=updated_by_client_duid,
             index=index,
             started_at=started_at,

{dart-tools-0.5.4 → dart_tools-0.5.6}/dart/generated/models/dartboard_create.py

@@ -1,5 +1,5 @@
 import datetime
-from typing import Any, Dict, List, Type, TypeVar, Union
+from typing import Any, Dict, List, Type, TypeVar, Union, cast
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
@@ -59,6 +59,8 @@ class DartboardCreate:
         index (Union[Unset, None, int]):
         started_at (Union[Unset, None, datetime.datetime]):
         finished_at (Union[Unset, None, datetime.datetime]):
+        always_shown_property_duids (Union[Unset, List[str]]):
+        always_hidden_property_duids (Union[Unset, List[str]]):
     """
 
     duid: str
@@ -73,6 +75,8 @@ class DartboardCreate:
     index: Union[Unset, None, int] = UNSET
     started_at: Union[Unset, None, datetime.datetime] = UNSET
     finished_at: Union[Unset, None, datetime.datetime] = UNSET
+    always_shown_property_duids: Union[Unset, List[str]] = UNSET
+    always_hidden_property_duids: Union[Unset, List[str]] = UNSET
     additional_properties: Dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> Dict[str, Any]:
@@ -103,6 +107,14 @@ class DartboardCreate:
         if not isinstance(self.finished_at, Unset):
             finished_at = self.finished_at.isoformat() if self.finished_at else None
 
+        always_shown_property_duids: Union[Unset, List[str]] = UNSET
+        if not isinstance(self.always_shown_property_duids, Unset):
+            always_shown_property_duids = self.always_shown_property_duids
+
+        always_hidden_property_duids: Union[Unset, List[str]] = UNSET
+        if not isinstance(self.always_hidden_property_duids, Unset):
+            always_hidden_property_duids = self.always_hidden_property_duids
+
         field_dict: Dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
@@ -130,6 +142,10 @@ class DartboardCreate:
             field_dict["startedAt"] = started_at
         if finished_at is not UNSET:
             field_dict["finishedAt"] = finished_at
+        if always_shown_property_duids is not UNSET:
+            field_dict["alwaysShownPropertyDuids"] = always_shown_property_duids
+        if always_hidden_property_duids is not UNSET:
+            field_dict["alwaysHiddenPropertyDuids"] = always_hidden_property_duids
 
         return field_dict
 
@@ -189,6 +205,10 @@ class DartboardCreate:
         else:
             finished_at = isoparse(_finished_at)
 
+        always_shown_property_duids = cast(List[str], d.pop("alwaysShownPropertyDuids", UNSET))
+
+        always_hidden_property_duids = cast(List[str], d.pop("alwaysHiddenPropertyDuids", UNSET))
+
         dartboard_create = cls(
             duid=duid,
             space_duid=space_duid,
@@ -202,6 +222,8 @@ class DartboardCreate:
             index=index,
             started_at=started_at,
             finished_at=finished_at,
+            always_shown_property_duids=always_shown_property_duids,
+            always_hidden_property_duids=always_hidden_property_duids,
         )
 
         dartboard_create.additional_properties = d

{dart-tools-0.5.4 → dart_tools-0.5.6}/dart/generated/models/dartboard_update.py

@@ -1,5 +1,5 @@
 import datetime
-from typing import Any, Dict, List, Type, TypeVar, Union
+from typing import Any, Dict, List, Type, TypeVar, Union, cast
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
@@ -59,6 +59,8 @@ class DartboardUpdate:
         index (Union[Unset, None, int]):
         started_at (Union[Unset, None, datetime.datetime]):
         finished_at (Union[Unset, None, datetime.datetime]):
+        always_shown_property_duids (Union[Unset, List[str]]):
+        always_hidden_property_duids (Union[Unset, List[str]]):
     """
 
     duid: str
@@ -73,6 +75,8 @@ class DartboardUpdate:
     index: Union[Unset, None, int] = UNSET
     started_at: Union[Unset, None, datetime.datetime] = UNSET
     finished_at: Union[Unset, None, datetime.datetime] = UNSET
+    always_shown_property_duids: Union[Unset, List[str]] = UNSET
+    always_hidden_property_duids: Union[Unset, List[str]] = UNSET
     additional_properties: Dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> Dict[str, Any]:
@@ -103,6 +107,14 @@ class DartboardUpdate:
         if not isinstance(self.finished_at, Unset):
             finished_at = self.finished_at.isoformat() if self.finished_at else None
 
+        always_shown_property_duids: Union[Unset, List[str]] = UNSET
+        if not isinstance(self.always_shown_property_duids, Unset):
+            always_shown_property_duids = self.always_shown_property_duids
+
+        always_hidden_property_duids: Union[Unset, List[str]] = UNSET
+        if not isinstance(self.always_hidden_property_duids, Unset):
+            always_hidden_property_duids = self.always_hidden_property_duids
+
         field_dict: Dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
@@ -132,6 +144,10 @@ class DartboardUpdate:
             field_dict["startedAt"] = started_at
         if finished_at is not UNSET:
             field_dict["finishedAt"] = finished_at
+        if always_shown_property_duids is not UNSET:
+            field_dict["alwaysShownPropertyDuids"] = always_shown_property_duids
+        if always_hidden_property_duids is not UNSET:
+            field_dict["alwaysHiddenPropertyDuids"] = always_hidden_property_duids
 
         return field_dict
 
@@ -191,6 +207,10 @@ class DartboardUpdate:
         else:
             finished_at = isoparse(_finished_at)
 
+        always_shown_property_duids = cast(List[str], d.pop("alwaysShownPropertyDuids", UNSET))
+
+        always_hidden_property_duids = cast(List[str], d.pop("alwaysHiddenPropertyDuids", UNSET))
+
         dartboard_update = cls(
             duid=duid,
             space_duid=space_duid,
@@ -204,6 +224,8 @@ class DartboardUpdate:
             index=index,
             started_at=started_at,
             finished_at=finished_at,
+            always_shown_property_duids=always_shown_property_duids,
+            always_hidden_property_duids=always_hidden_property_duids,
         )
 
         dartboard_update.additional_properties = d

{dart-tools-0.5.4 → dart_tools-0.5.6}/dart/generated/models/doc_create.py

@@ -17,8 +17,6 @@ class DocCreate:
     """
     Attributes:
         duid (str):
-        folder_duid (str):
-        order (str):
         source_user (Union[Unset, None, str]):
         source_type (Union[Unset, DocSourceType]): * `Unknown` - UNKNOWN
             * `Onboarding` - ONBOARDING
@@ -28,10 +26,13 @@ class DocCreate:
             * `Application` - APPLICATION Default: DocSourceType.UNKNOWN.
         drafter_duid (Union[Unset, None, str]):
         in_trash (Union[Unset, bool]):
+        folder_duid (Union[Unset, str]):
         report_kind (Union[Unset, None, ReportKind]): * `Standup` - STANDUP
             * `Changelog` - CHANGELOG
+        order (Union[Unset, str]):
         title (Union[Unset, str]):
         text (Union[Unset, Any]):
+        text_markdown (Union[Unset, str]):
         edited_by_ai (Union[Unset, bool]):
         recommendation_duid (Union[Unset, None, str]):
         editor_duids (Union[Unset, List[str]]):
@@ -67,15 +68,16 @@ class DocCreate:
     """
 
     duid: str
-    folder_duid: str
-    order: str
     source_user: Union[Unset, None, str] = UNSET
     source_type: Union[Unset, DocSourceType] = DocSourceType.UNKNOWN
     drafter_duid: Union[Unset, None, str] = UNSET
     in_trash: Union[Unset, bool] = UNSET
+    folder_duid: Union[Unset, str] = UNSET
     report_kind: Union[Unset, None, ReportKind] = UNSET
+    order: Union[Unset, str] = UNSET
     title: Union[Unset, str] = UNSET
     text: Union[Unset, Any] = UNSET
+    text_markdown: Union[Unset, str] = UNSET
     edited_by_ai: Union[Unset, bool] = UNSET
     recommendation_duid: Union[Unset, None, str] = UNSET
     editor_duids: Union[Unset, List[str]] = UNSET
@@ -87,8 +89,6 @@ class DocCreate:
 
     def to_dict(self) -> Dict[str, Any]:
         duid = self.duid
-        folder_duid = self.folder_duid
-        order = self.order
         source_user = self.source_user
         source_type: Union[Unset, str] = UNSET
         if not isinstance(self.source_type, Unset):
@@ -96,12 +96,15 @@ class DocCreate:
 
         drafter_duid = self.drafter_duid
         in_trash = self.in_trash
+        folder_duid = self.folder_duid
         report_kind: Union[Unset, None, str] = UNSET
         if not isinstance(self.report_kind, Unset):
             report_kind = self.report_kind.value if self.report_kind else None
 
+        order = self.order
         title = self.title
         text = self.text
+        text_markdown = self.text_markdown
         edited_by_ai = self.edited_by_ai
         recommendation_duid = self.recommendation_duid
         editor_duids: Union[Unset, List[str]] = UNSET
@@ -126,8 +129,6 @@ class DocCreate:
         field_dict.update(
             {
                 "duid": duid,
-                "folderDuid": folder_duid,
-                "order": order,
             }
         )
         if source_user is not UNSET:
@@ -138,12 +139,18 @@ class DocCreate:
             field_dict["drafterDuid"] = drafter_duid
         if in_trash is not UNSET:
             field_dict["inTrash"] = in_trash
+        if folder_duid is not UNSET:
+            field_dict["folderDuid"] = folder_duid
         if report_kind is not UNSET:
             field_dict["reportKind"] = report_kind
+        if order is not UNSET:
+            field_dict["order"] = order
         if title is not UNSET:
             field_dict["title"] = title
         if text is not UNSET:
             field_dict["text"] = text
+        if text_markdown is not UNSET:
+            field_dict["textMarkdown"] = text_markdown
         if edited_by_ai is not UNSET:
             field_dict["editedByAi"] = edited_by_ai
         if recommendation_duid is not UNSET:
@@ -166,10 +173,6 @@ class DocCreate:
         d = src_dict.copy()
         duid = d.pop("duid")
 
-        folder_duid = d.pop("folderDuid")
-
-        order = d.pop("order")
-
         source_user = d.pop("sourceUser", UNSET)
 
         _source_type = d.pop("sourceType", UNSET)
@@ -183,6 +186,8 @@ class DocCreate:
 
         in_trash = d.pop("inTrash", UNSET)
 
+        folder_duid = d.pop("folderDuid", UNSET)
+
         _report_kind = d.pop("reportKind", UNSET)
         report_kind: Union[Unset, None, ReportKind]
         if _report_kind is None:
@@ -192,10 +197,14 @@ class DocCreate:
         else:
             report_kind = ReportKind(_report_kind)
 
+        order = d.pop("order", UNSET)
+
         title = d.pop("title", UNSET)
 
         text = d.pop("text", UNSET)
 
+        text_markdown = d.pop("textMarkdown", UNSET)
+
         edited_by_ai = d.pop("editedByAi", UNSET)
 
         recommendation_duid = d.pop("recommendationDuid", UNSET)
@@ -222,15 +231,16 @@ class DocCreate:
 
         doc_create = cls(
             duid=duid,
-            folder_duid=folder_duid,
-            order=order,
             source_user=source_user,
             source_type=source_type,
             drafter_duid=drafter_duid,
             in_trash=in_trash,
+            folder_duid=folder_duid,
             report_kind=report_kind,
+            order=order,
             title=title,
             text=text,
+            text_markdown=text_markdown,
             edited_by_ai=edited_by_ai,
             recommendation_duid=recommendation_duid,
             editor_duids=editor_duids,

{dart-tools-0.5.4 → dart_tools-0.5.6}/dart/generated/models/doc_update.py

@@ -32,6 +32,7 @@ class DocUpdate:
         order (Union[Unset, str]):
         title (Union[Unset, str]):
         text (Union[Unset, Any]):
+        text_markdown (Union[Unset, str]):
         edited_by_ai (Union[Unset, bool]):
         recommendation_duid (Union[Unset, None, str]):
         editor_duids (Union[Unset, List[str]]):
@@ -76,6 +77,7 @@ class DocUpdate:
     order: Union[Unset, str] = UNSET
     title: Union[Unset, str] = UNSET
     text: Union[Unset, Any] = UNSET
+    text_markdown: Union[Unset, str] = UNSET
     edited_by_ai: Union[Unset, bool] = UNSET
     recommendation_duid: Union[Unset, None, str] = UNSET
     editor_duids: Union[Unset, List[str]] = UNSET
@@ -102,6 +104,7 @@ class DocUpdate:
         order = self.order
         title = self.title
         text = self.text
+        text_markdown = self.text_markdown
         edited_by_ai = self.edited_by_ai
         recommendation_duid = self.recommendation_duid
         editor_duids: Union[Unset, List[str]] = UNSET
@@ -146,6 +149,8 @@ class DocUpdate:
             field_dict["title"] = title
         if text is not UNSET:
             field_dict["text"] = text
+        if text_markdown is not UNSET:
+            field_dict["textMarkdown"] = text_markdown
         if edited_by_ai is not UNSET:
             field_dict["editedByAi"] = edited_by_ai
         if recommendation_duid is not UNSET:
@@ -198,6 +203,8 @@ class DocUpdate:
 
         text = d.pop("text", UNSET)
 
+        text_markdown = d.pop("textMarkdown", UNSET)
+
         edited_by_ai = d.pop("editedByAi", UNSET)
 
         recommendation_duid = d.pop("recommendationDuid", UNSET)
@@ -233,6 +240,7 @@ class DocUpdate:
             order=order,
             title=title,
             text=text,
+            text_markdown=text_markdown,
             edited_by_ai=edited_by_ai,
             recommendation_duid=recommendation_duid,
             editor_duids=editor_duids,

{dart-tools-0.5.4 → dart_tools-0.5.6}/dart/generated/models/event.py

@@ -102,13 +102,13 @@ class Event:
         message (Optional[str]):
         actor_duid (Optional[str]):
         actor_str (Optional[EventActor]): * `Dart AI` - DART_AI
-            * `Dart due date bot` - DART_DUE_DATE_BOT
-            * `Dart GitHub bot` - DART_GITHUB_BOT
-            * `Dart metrics bot` - DART_METRICS_BOT
-            * `Dart recurring task bot` - DART_RECURRING_TASK_BOT
-            * `Dart reminder bot` - DART_REMINDER_BOT
-            * `Dart report bot` - DART_REPORT_BOT
-            * `Dart Slack bot` - DART_SLACK_BOT
+            * `Dart Due Date Bot` - DART_DUE_DATE_BOT
+            * `Dart GitHub Bot` - DART_GITHUB_BOT
+            * `Dart Metrics Bot` - DART_METRICS_BOT
+            * `Dart Recurring Task Bot` - DART_RECURRING_TASK_BOT
+            * `Dart Reminder Bot` - DART_REMINDER_BOT
+            * `Dart Report Bot` - DART_REPORT_BOT
+            * `Dart Slack Bot` - DART_SLACK_BOT
             * `A form user` - FORM_USER
             * `An email user` - EMAIL_USER
             * `Stripe webhook` - STRIPE_WEBHOOK

dart_tools-0.5.6/dart/generated/models/event_actor.py

@@ -0,0 +1,18 @@
+from enum import Enum
+
+
+class EventActor(str, Enum):
+    AN_EMAIL_USER = "An email user"
+    A_FORM_USER = "A form user"
+    DART_AI = "Dart AI"
+    DART_DUE_DATE_BOT = "Dart Due Date Bot"
+    DART_GITHUB_BOT = "Dart GitHub Bot"
+    DART_METRICS_BOT = "Dart Metrics Bot"
+    DART_RECURRING_TASK_BOT = "Dart Recurring Task Bot"
+    DART_REMINDER_BOT = "Dart Reminder Bot"
+    DART_REPORT_BOT = "Dart Report Bot"
+    DART_SLACK_BOT = "Dart Slack Bot"
+    STRIPE_WEBHOOK = "Stripe webhook"
+
+    def __str__(self) -> str:
+        return str(self.value)