dart-tools 0.7.0__tar.gz → 0.7.1__tar.gz

{dart_tools-0.7.0 → dart_tools-0.7.1}/PKG-INFO

@@ -1,9 +1,30 @@
 Metadata-Version: 2.4
 Name: dart-tools
-Version: 0.7.0
+Version: 0.7.1
 Summary: The Dart CLI and Python Library
 Author-email: Dart <software@itsdart.com>
-License-Expression: MIT
+License: MIT License
+        
+        Copyright (c) 2023 Dart
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
 Project-URL: Homepage, https://www.itsdart.com/?nr=1
 Project-URL: Web App, https://app.itsdart.com/
 Project-URL: Help Center, https://help.itsdart.com/
@@ -13,6 +34,7 @@ Keywords: dart,cli,projectmanagement,taskmanagement
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
@@ -52,52 +74,63 @@ Dynamic: license-file
 
 `dart-tools` is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python.
 
-
 - [Installation](#installation)
+  - [Naming conflicts](#naming-conflicts)
 - [Using the CLI](#using-the-cli)
 - [Using the Python Library](#using-the-python-library)
 - [Using the Python Library in AWS Lambda Functions](#using-the-python-library-in-aws-lambda-functions)
-- [Advanced Usage](#advanced-usage)
+  - [Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.](#navigate-to-the-directory-containing-your-lambda_functionpy-source-file-in-this-example-the-directory-is-named-my_function)
+  - [Create a Deployment Package](#create-a-deployment-package)
+  - [Zip the contents of the `package` directory along with your `lambda_function.py`](#zip-the-contents-of-the-package-directory-along-with-your-lambda_functionpy)
+  - [Deploy the Lambda function](#deploy-the-lambda-function)
 - [Help and Resources](#help-and-resources)
 - [Contributing](#contributing)
 - [License](#license)
 
-
 ## Installation
 
 In the terminal, install by running
+
 ```sh
 pip install dart-tools
 ```
 
+### Naming conflicts
+
+If you have a preexisting shell command named `dart`, a quick fix is to run `which -a dart` and fine the path for this `dart` application. Then you can create an alias and add it to your shell profile file (`.zshrc`, `.bashrc`, etc.). For example, open `~/.zshrc` and add a line like `alias dartai="/path/to/dart"`, save it, and restart your terminal.
 
 ## Using the CLI
 
 Start off by setting up authentication with
+
 ```sh
 dart login
 ```
 
 Then, you can create a new task with a command along the lines of
+
 ```sh
 dart task-create "Update the landing page" -p0 --tag marketing
 ```
+
 which will make a new task called 'Update the landing page' with priority 'Critical' (i.e. P0) and with the 'marketing' tag.
 
 You can explore all of these options and many more with `dart --help` or the more specific help for subcommands, in this case `dart task-create --help`.
 
 Another common workflow is to updating a preexisting task. To do this, run something like
+
 ```sh
 dart task-update [ID] -s Done
 ```
-This command will mark the referenced task 'Done'. Here `[ID]` is meant to be replaced (including the brackets) with the ID of an existing task. You can get a ID from any existing task in a number of ways, such as by copying it from the end of a task's URL or by clicking the '...' button in a task page in Dart and then choosing 'Copy ID'.
 
+This command will mark the referenced task 'Done'. Here `[ID]` is meant to be replaced (including the brackets) with the ID of an existing task. You can get a ID from any existing task in a number of ways, such as by copying it from the end of a task's URL or by clicking the '...' button in a task page in Dart and then choosing 'Copy ID'.
 
 ## Using the Python Library
 
 First, set up authentication. Run `dart login` in the terminal for an interactive process. Alternatively, copy your authentication token from [your Dart profile](https://app.itsdart.com/?settings=account) and save that as the `DART_TOKEN` environment variable.
 
 Then, you can run something like
+
 ```python
 import os
 from dart import create_task, is_logged_in, update_task
@@ -114,18 +147,17 @@ new_task = create_task(
 update_task(new_task.id, status_title="Done")
 ```
 
-
 ## Using the Python Library in AWS Lambda Functions
 
 To use the `dart-tools` Python library in an AWS Lambda function, you need to package the library with your Lambda deployment package (see more details at [Working with .zip file archives for Python Lambda functions](https://docs.aws.amazon.com/lambda/latest/dg/python-package.html)). Follow these steps:
 
-1. Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.
+### Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.
 
   ```sh
   cd my_function
   ```
 
-2. Create a Deployment Package
+### Create a Deployment Package
 
   Use Docker to create a deployment package that includes the `dart-tools` library. Run the following commands in your terminal, ensuring that the `RUNTIME_PYTHON_VERSION` and `RUNTIME_ARCHITECTURE` environment variables match the runtime settings of your Lambda function:
 
@@ -137,7 +169,7 @@ To use the `dart-tools` Python library in an AWS Lambda function, you need to pa
 
   This command installs the `dart-tools` library into a directory named `package` in your current working directory.
 
-3. Zip the contents of the `package` directory along with your `lambda_function.py`
+### Zip the contents of the `package` directory along with your `lambda_function.py`
 
   ```sh
   cd package
@@ -146,16 +178,15 @@ To use the `dart-tools` Python library in an AWS Lambda function, you need to pa
   zip -r my_deployment_package.zip lambda_function.py
   ```
 
-4. Deploy the Lambda function
+### Deploy the Lambda function
 
   Upload the `my_deployment_package.zip` file to AWS Lambda using the AWS Management Console or the AWS CLI.
 
 By following these steps, you can use the `dart-tools` Python library within your AWS Lambda functions.
 
-
 ## Help and Resources
 
-- [Homepage](https://www.itsdart.com/?nr=1)
+- [Homepage](https://itsdart.com/?nr=1)
 - [Web App](https://app.itsdart.com/)
 - [Help Center](https://help.itsdart.com/)
 - [Bugs and Features](https://app.itsdart.com/p/r/JFyPnhL9En61)

{dart_tools-0.7.0 → dart_tools-0.7.1}/README.md

@@ -11,52 +11,63 @@
 
 `dart-tools` is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python.
 
-
 - [Installation](#installation)
+  - [Naming conflicts](#naming-conflicts)
 - [Using the CLI](#using-the-cli)
 - [Using the Python Library](#using-the-python-library)
 - [Using the Python Library in AWS Lambda Functions](#using-the-python-library-in-aws-lambda-functions)
-- [Advanced Usage](#advanced-usage)
+  - [Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.](#navigate-to-the-directory-containing-your-lambda_functionpy-source-file-in-this-example-the-directory-is-named-my_function)
+  - [Create a Deployment Package](#create-a-deployment-package)
+  - [Zip the contents of the `package` directory along with your `lambda_function.py`](#zip-the-contents-of-the-package-directory-along-with-your-lambda_functionpy)
+  - [Deploy the Lambda function](#deploy-the-lambda-function)
 - [Help and Resources](#help-and-resources)
 - [Contributing](#contributing)
 - [License](#license)
 
-
 ## Installation
 
 In the terminal, install by running
+
 ```sh
 pip install dart-tools
 ```
 
+### Naming conflicts
+
+If you have a preexisting shell command named `dart`, a quick fix is to run `which -a dart` and fine the path for this `dart` application. Then you can create an alias and add it to your shell profile file (`.zshrc`, `.bashrc`, etc.). For example, open `~/.zshrc` and add a line like `alias dartai="/path/to/dart"`, save it, and restart your terminal.
 
 ## Using the CLI
 
 Start off by setting up authentication with
+
 ```sh
 dart login
 ```
 
 Then, you can create a new task with a command along the lines of
+
 ```sh
 dart task-create "Update the landing page" -p0 --tag marketing
 ```
+
 which will make a new task called 'Update the landing page' with priority 'Critical' (i.e. P0) and with the 'marketing' tag.
 
 You can explore all of these options and many more with `dart --help` or the more specific help for subcommands, in this case `dart task-create --help`.
 
 Another common workflow is to updating a preexisting task. To do this, run something like
+
 ```sh
 dart task-update [ID] -s Done
 ```
-This command will mark the referenced task 'Done'. Here `[ID]` is meant to be replaced (including the brackets) with the ID of an existing task. You can get a ID from any existing task in a number of ways, such as by copying it from the end of a task's URL or by clicking the '...' button in a task page in Dart and then choosing 'Copy ID'.
 
+This command will mark the referenced task 'Done'. Here `[ID]` is meant to be replaced (including the brackets) with the ID of an existing task. You can get a ID from any existing task in a number of ways, such as by copying it from the end of a task's URL or by clicking the '...' button in a task page in Dart and then choosing 'Copy ID'.
 
 ## Using the Python Library
 
 First, set up authentication. Run `dart login` in the terminal for an interactive process. Alternatively, copy your authentication token from [your Dart profile](https://app.itsdart.com/?settings=account) and save that as the `DART_TOKEN` environment variable.
 
 Then, you can run something like
+
 ```python
 import os
 from dart import create_task, is_logged_in, update_task
@@ -73,18 +84,17 @@ new_task = create_task(
 update_task(new_task.id, status_title="Done")
 ```
 
-
 ## Using the Python Library in AWS Lambda Functions
 
 To use the `dart-tools` Python library in an AWS Lambda function, you need to package the library with your Lambda deployment package (see more details at [Working with .zip file archives for Python Lambda functions](https://docs.aws.amazon.com/lambda/latest/dg/python-package.html)). Follow these steps:
 
-1. Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.
+### Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.
 
   ```sh
   cd my_function
   ```
 
-2. Create a Deployment Package
+### Create a Deployment Package
 
   Use Docker to create a deployment package that includes the `dart-tools` library. Run the following commands in your terminal, ensuring that the `RUNTIME_PYTHON_VERSION` and `RUNTIME_ARCHITECTURE` environment variables match the runtime settings of your Lambda function:
 
@@ -96,7 +106,7 @@ To use the `dart-tools` Python library in an AWS Lambda function, you need to pa
 
   This command installs the `dart-tools` library into a directory named `package` in your current working directory.
 
-3. Zip the contents of the `package` directory along with your `lambda_function.py`
+### Zip the contents of the `package` directory along with your `lambda_function.py`
 
   ```sh
   cd package
@@ -105,16 +115,15 @@ To use the `dart-tools` Python library in an AWS Lambda function, you need to pa
   zip -r my_deployment_package.zip lambda_function.py
   ```
 
-4. Deploy the Lambda function
+### Deploy the Lambda function
 
   Upload the `my_deployment_package.zip` file to AWS Lambda using the AWS Management Console or the AWS CLI.
 
 By following these steps, you can use the `dart-tools` Python library within your AWS Lambda functions.
 
-
 ## Help and Resources
 
-- [Homepage](https://www.itsdart.com/?nr=1)
+- [Homepage](https://itsdart.com/?nr=1)
 - [Web App](https://app.itsdart.com/)
 - [Help Center](https://help.itsdart.com/)
 - [Bugs and Features](https://app.itsdart.com/p/r/JFyPnhL9En61)

{dart_tools-0.7.0 → dart_tools-0.7.1}/dart/dart.py

@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
+#!/usr/bin/env uv run python3
 # -*- coding: utf-8 -*-
 
 """A CLI to interact with the Dart web app."""
@@ -19,7 +19,7 @@ from collections import defaultdict
 from datetime import timezone
 from functools import wraps
 from importlib.metadata import version
-from typing import Callable, NoReturn, TypeVar
+from typing import Callable, NoReturn, TypeVar, Union
 from webbrowser import open_new_tab
 
 import dateparser
@@ -27,8 +27,6 @@ import httpx
 import platformdirs
 from pick import pick
 
-from dart.generated.types import Response
-
 from .exception import DartException
 from .generated import Client, api
 from .generated.models import (
@@ -54,7 +52,7 @@ from .generated.models import (
     WrappedTaskCreate,
     WrappedTaskUpdate,
 )
-from .generated.types import UNSET, Unset
+from .generated.types import UNSET, Response, Unset
 
 _APP = "dart-tools"
 _PROG = "dart"
@@ -66,7 +64,7 @@ _HOST_MAP = {"prod": _PROD_HOST, "stag": _STAG_HOST, "dev": _DEV_HOST}
 
 # Service commands
 _LOGIN_CMD = "login"
-_SET_HOST_CMD = "sethost"
+_SET_HOST_CMD = "host-set"
 _VERSION_CMD = "--version"
 # Task commands
 _CREATE_TASK_CMD = "task-create"
@@ -131,7 +129,7 @@ def _make_id() -> str:
     return "".join(random.choices(_ID_CHARS, k=12))
 
 
-def trim_slug_str(s: str, length: int, max_under: int | None = None) -> str:
+def trim_slug_str(s: str, length: int, max_under: Union[int, None] = None) -> str:
     max_under = max_under if max_under is not None else length // 6
     if len(s) <= length:
         return s
@@ -141,7 +139,7 @@ def trim_slug_str(s: str, length: int, max_under: int | None = None) -> str:
     return s[:length]
 
 
-def slugify_str(s: str, lower: bool = False, trim_kwargs: dict | None = None) -> str:
+def slugify_str(s: str, lower: bool = False, trim_kwargs: Union[dict, None] = None) -> str:
     lowered = s.lower() if lower else s
     formatted = _NON_ALPHANUM_RE.sub("-", lowered.replace("'", ""))
     formatted = _REPEATED_DASH_RE.sub("-", formatted).strip("-")
@@ -205,7 +203,7 @@ def _handle_request_errors(fn: Callable) -> Callable:
         except DartException as ex:
             _dart_exit(ex)
         except (httpx.TimeoutException, httpx.RequestError, httpx.ConnectError) as ex:
-            _dart_exit(f"Failed to execute API call. Reason: {ex}.")
+            _dart_exit(f"Failed to execute API call: {ex}.")
 
     return wrapper
 
@@ -276,7 +274,7 @@ class Dart:
     def get_client_id(self) -> str:
         return self._config.client_id
 
-    def get_auth_token(self) -> str | None:
+    def get_auth_token(self) -> Union[str, None]:
         result = self._config.get(_AUTH_TOKEN_KEY)
         if result is not None:
             return result
@@ -456,7 +454,7 @@ def _auth_failure_exit() -> NoReturn:
     _dart_exit(
         f"Not logged in, run\n\n  {_PROG} {_LOGIN_CMD}\n\nto log in."
         if _is_cli
-        else "Not logged in, either run dart.login(token) or save the token into the DART_TOKEN environment variable."
+        else "Not logged in, either run\n\n  dart.login(token)\n\nor save the token into the DART_TOKEN environment variable."
     )
 
 
@@ -492,7 +490,7 @@ def is_logged_in(should_raise: bool = False) -> bool:
 
     if not result and should_raise:
         _auth_failure_exit()
-    _log(f"You are {'' if result else 'not '}logged in")
+    _log(f"You are{'' if result else ' not'} logged in")
     return result
 
 
@@ -555,7 +553,7 @@ def begin_task() -> bool:
     return True
 
 
-def _normalize_priority(priority_int: int | None | Unset) -> str | None | Unset:
+def _normalize_priority(priority_int: Union[int, None, Unset]) -> Union[str, None, Unset]:
     if priority_int in (None, UNSET):
         return priority_int
 
@@ -565,13 +563,13 @@ def _normalize_priority(priority_int: int | None | Unset) -> str | None | Unset:
     return _PRIORITY_MAP[priority_int]
 
 
-def _get_due_at_from_str_arg(due_at_str: str | None | Unset) -> str | None | Unset:
+def _get_due_at_from_str_arg(due_at_str: Union[str, None, Unset]) -> Union[str, None, Unset]:
     if due_at_str in (None, UNSET):
         return due_at_str
 
     due_at = dateparser.parse(due_at_str)
     if not due_at:
-        _dart_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=0, minute=0, second=0, microsecond=0, tzinfo=timezone.utc).isoformat()
 
     return due_at
@@ -580,13 +578,13 @@ def _get_due_at_from_str_arg(due_at_str: str | None | Unset) -> str | None | Uns
 def create_task(
     title: str,
     *,
-    dartboard_title: str | Unset = UNSET,
-    status_title: str | Unset = UNSET,
-    assignee_emails: list[str] | Unset = UNSET,
-    tag_titles: list[str] | Unset = UNSET,
-    priority_int: int | None | Unset = UNSET,
-    size_int: int | None | Unset = UNSET,
-    due_at_str: str | None | Unset = UNSET,
+    dartboard_title: Union[str, Unset] = UNSET,
+    status_title: Union[str, Unset] = UNSET,
+    assignee_emails: Union[list[str], Unset] = UNSET,
+    tag_titles: Union[list[str], Unset] = UNSET,
+    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()
@@ -603,7 +601,7 @@ def create_task(
         )
     )
     task = dart.create_task(task_create).item
-    _log(f"Created task (ID: {task.id}) {task.title} at {task.html_url}")
+    _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
@@ -616,14 +614,14 @@ def create_task(
 def update_task(
     id: str,
     *,
-    title: Unset | str = UNSET,
-    dartboard_title: str | Unset = UNSET,
-    status_title: str | Unset = UNSET,
-    assignee_emails: list[str] | Unset = UNSET,
-    tag_titles: list[str] | Unset = UNSET,
-    priority_int: int | None | Unset = UNSET,
-    size_int: int | None | Unset = UNSET,
-    due_at_str: str | None | Unset = UNSET,
+    title: Union[Unset, str] = UNSET,
+    dartboard_title: Union[str, Unset] = UNSET,
+    status_title: Union[str, Unset] = UNSET,
+    assignee_emails: Union[list[str], Unset] = UNSET,
+    tag_titles: Union[list[str], Unset] = UNSET,
+    priority_int: Union[int, None, Unset] = UNSET,
+    size_int: Union[int, None, Unset] = UNSET,
+    due_at_str: Union[str, None, Unset] = UNSET,
 ) -> Task:
     dart = Dart()
     task_update = WrappedTaskUpdate(
@@ -641,7 +639,7 @@ def update_task(
     )
     task = dart.update_task(id, task_update).item
 
-    _log(f"Updated task (ID: {task.id}) {task.title} at {task.html_url}")
+    _log(f"Updated task\n\n  {task.title}\n  {task.html_url}\n  ID: {task.id}\n")
     _log("Done.")
     return task
 
@@ -650,7 +648,7 @@ def delete_task(id: str) -> Task:
     dart = Dart()
     task = dart.delete_task(id).item
 
-    _log(f"Deleted task (ID: {task.id}) {task.title} at {task.html_url}")
+    _log(f"Deleted task\n\n  {task.title}\n  {task.html_url}\n  ID: {task.id}\n")
     _log("Done.")
     return task
 
@@ -658,14 +656,14 @@ def delete_task(id: str) -> Task:
 def create_doc(
     title: str,
     *,
-    folder: str | Unset = UNSET,
-    text: str | Unset = UNSET,
+    folder: Union[str, Unset] = UNSET,
+    text: Union[str, Unset] = UNSET,
 ) -> Doc:
     dart = Dart()
     doc_create = WrappedDocCreate(item=DocCreate(title=title, folder=folder, text=text))
     doc = dart.create_doc(doc_create).item
 
-    _log(f"Created doc (ID: {doc.id}) {doc.title} at {doc.html_url}")
+    _log(f"Created doc\n\n  {doc.title}\n  {doc.html_url}\n  ID: {doc.id}\n")
     _log("Done.")
     return doc
 
@@ -674,14 +672,14 @@ def update_doc(
     id: str,
     *,
     title: str,
-    folder: str | Unset = UNSET,
-    text: str | Unset = UNSET,
+    folder: Union[str, Unset] = UNSET,
+    text: Union[str, Unset] = UNSET,
 ) -> Doc:
     dart = Dart()
     doc_update = WrappedDocUpdate(item=DocUpdate(id, title=title, folder=folder, text=text))
     doc = dart.update_doc(id, doc_update).item
 
-    _log(f"Updated doc (ID: {doc.id}) {doc.title} at {doc.html_url}")
+    _log(f"Updated doc\n\n  {doc.title}\n  {doc.html_url}\n  ID: {doc.id}\n")
     _log("Done.")
     return doc
 
@@ -690,7 +688,7 @@ def delete_doc(id: str) -> Doc:
     dart = Dart()
     doc = dart.delete_doc(id).item
 
-    _log(f"Deleted doc (ID: {doc.id}) {doc.title} at {doc.html_url}")
+    _log(f"Deleted doc\n\n  {doc.title}\n  {doc.html_url}\n  ID: {doc.id}\n")
     _log("Done.")
     return doc
 
@@ -699,7 +697,7 @@ def create_comment(id: str, text: str) -> Comment:
     dart = Dart()
     comment_create = WrappedCommentCreate(item=CommentCreate(task_id=id, text=text))
     comment = dart.create_comment(comment_create).item
-    _log(f"Created comment (ID: {comment.id}) at {comment.html_url}")
+    _log(f"Created comment\n\n  {comment.html_url}\n  ID: {comment.id}\n")
     _log("Done.")
     return comment
 
@@ -793,7 +791,7 @@ def cli() -> None:
         metavar=f"{{{metavar}}}",
     )
 
-    set_host_parser = subparsers.add_parser(_SET_HOST_CMD, aliases=["h"])
+    set_host_parser = subparsers.add_parser(_SET_HOST_CMD, aliases=["sh"])
     set_host_parser.add_argument("host", help="the new host: {prod|stag|dev|[URL]}")
     set_host_parser.set_defaults(func=set_host)
 

{dart_tools-0.7.0 → dart_tools-0.7.1}/dart/old.py

@@ -7,7 +7,7 @@
 from __future__ import annotations
 
 from functools import wraps
-from typing import Any, Callable
+from typing import Any, Callable, Union
 
 import httpx
 
@@ -95,11 +95,11 @@ class DartOld(Dart):
 def replicate_space(
     space_id: str,
     *,
-    title: str | None = None,
-    abrev: str | None = None,
-    color_hex: str | None = None,
-    accessible_by_team: bool | None = None,
-    accessor_duids: list[str] | None = None,
+    title: Union[str, None] = None,
+    abrev: Union[str, None] = None,
+    color_hex: Union[str, None] = None,
+    accessible_by_team: Union[bool, None] = None,
+    accessor_duids: Union[list[str], None] = None,
 ) -> str:
     dart = DartOld()
     content = {}
@@ -135,7 +135,7 @@ def get_dartboards(space_id: str, include_special: bool = False) -> list[dict]:
     return dartboards
 
 
-def replicate_dartboard(dartboard_id: str, *, title: str | None = None) -> str:
+def replicate_dartboard(dartboard_id: str, *, title: Union[str, None] = None) -> str:
     dart = DartOld()
     content = {}
     if title is not None:
@@ -148,7 +148,7 @@ def replicate_dartboard(dartboard_id: str, *, title: str | None = None) -> str:
     return dartboard_id
 
 
-def update_dartboard(dartboard_id: str, *, title: str | None = None, color_hex: str | None = None) -> dict:
+def update_dartboard(dartboard_id: str, *, title: Union[str, None] = None, color_hex: Union[str, None] = None) -> dict:
     dart = DartOld()
     dartboard_update = {}
 
@@ -170,12 +170,12 @@ def update_dartboard(dartboard_id: str, *, title: str | None = None, color_hex:
     response_json = response.json()
     dartboard = _parse_transaction_response_and_maybe_exit(response_json, "dartboard", dartboard_id)
 
-    _log(f"Updated dartboard {dartboard["title"]} at {_get_dartboard_url(dart.get_base_url(), dartboard["duid"])}")
+    _log(f"Updated dartboard {dartboard['title']} at {_get_dartboard_url(dart.get_base_url(), dartboard['duid'])}")
     _log("Done.")
     return dartboard
 
 
-def get_folders(space_id: str, *, include_special: bool = False) -> list[dict]:
+def get_folders(space_id: str, *, include_special: Union[bool, None] = False) -> list[dict]:
     dart = DartOld()
 
     response = dart.get(_LIST_FOLDERS_URL_FRAG, params={"space_duid": space_id})
@@ -189,7 +189,7 @@ def get_folders(space_id: str, *, include_special: bool = False) -> list[dict]:
     return folders
 
 
-def update_folder(folder_id: str, *, title: str | None = None, color_hex: str | None = None) -> dict:
+def update_folder(folder_id: str, *, title: Union[str, None] = None, color_hex: Union[str, None] = None) -> dict:
     dart = DartOld()
     folder_update = {}
 
@@ -211,6 +211,6 @@ def update_folder(folder_id: str, *, title: str | None = None, color_hex: str |
     response_json = response.json()
     folder = _parse_transaction_response_and_maybe_exit(response_json, "folder", folder_id)
 
-    _log(f"Updated folder {folder["title"]} at {_get_folder_url(dart.get_base_url(), folder["duid"])}")
+    _log(f"Updated folder {folder['title']} at {_get_folder_url(dart.get_base_url(), folder['duid'])}")
     _log("Done.")
     return folder

{dart_tools-0.7.0 → dart_tools-0.7.1}/dart_tools.egg-info/PKG-INFO

@@ -1,9 +1,30 @@
 Metadata-Version: 2.4
 Name: dart-tools
-Version: 0.7.0
+Version: 0.7.1
 Summary: The Dart CLI and Python Library
 Author-email: Dart <software@itsdart.com>
-License-Expression: MIT
+License: MIT License
+        
+        Copyright (c) 2023 Dart
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
 Project-URL: Homepage, https://www.itsdart.com/?nr=1
 Project-URL: Web App, https://app.itsdart.com/
 Project-URL: Help Center, https://help.itsdart.com/
@@ -13,6 +34,7 @@ Keywords: dart,cli,projectmanagement,taskmanagement
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
@@ -52,52 +74,63 @@ Dynamic: license-file
 
 `dart-tools` is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python.
 
-
 - [Installation](#installation)
+  - [Naming conflicts](#naming-conflicts)
 - [Using the CLI](#using-the-cli)
 - [Using the Python Library](#using-the-python-library)
 - [Using the Python Library in AWS Lambda Functions](#using-the-python-library-in-aws-lambda-functions)
-- [Advanced Usage](#advanced-usage)
+  - [Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.](#navigate-to-the-directory-containing-your-lambda_functionpy-source-file-in-this-example-the-directory-is-named-my_function)
+  - [Create a Deployment Package](#create-a-deployment-package)
+  - [Zip the contents of the `package` directory along with your `lambda_function.py`](#zip-the-contents-of-the-package-directory-along-with-your-lambda_functionpy)
+  - [Deploy the Lambda function](#deploy-the-lambda-function)
 - [Help and Resources](#help-and-resources)
 - [Contributing](#contributing)
 - [License](#license)
 
-
 ## Installation
 
 In the terminal, install by running
+
 ```sh
 pip install dart-tools
 ```
 
+### Naming conflicts
+
+If you have a preexisting shell command named `dart`, a quick fix is to run `which -a dart` and fine the path for this `dart` application. Then you can create an alias and add it to your shell profile file (`.zshrc`, `.bashrc`, etc.). For example, open `~/.zshrc` and add a line like `alias dartai="/path/to/dart"`, save it, and restart your terminal.
 
 ## Using the CLI
 
 Start off by setting up authentication with
+
 ```sh
 dart login
 ```
 
 Then, you can create a new task with a command along the lines of
+
 ```sh
 dart task-create "Update the landing page" -p0 --tag marketing
 ```
+
 which will make a new task called 'Update the landing page' with priority 'Critical' (i.e. P0) and with the 'marketing' tag.
 
 You can explore all of these options and many more with `dart --help` or the more specific help for subcommands, in this case `dart task-create --help`.
 
 Another common workflow is to updating a preexisting task. To do this, run something like
+
 ```sh
 dart task-update [ID] -s Done
 ```
-This command will mark the referenced task 'Done'. Here `[ID]` is meant to be replaced (including the brackets) with the ID of an existing task. You can get a ID from any existing task in a number of ways, such as by copying it from the end of a task's URL or by clicking the '...' button in a task page in Dart and then choosing 'Copy ID'.
 
+This command will mark the referenced task 'Done'. Here `[ID]` is meant to be replaced (including the brackets) with the ID of an existing task. You can get a ID from any existing task in a number of ways, such as by copying it from the end of a task's URL or by clicking the '...' button in a task page in Dart and then choosing 'Copy ID'.
 
 ## Using the Python Library
 
 First, set up authentication. Run `dart login` in the terminal for an interactive process. Alternatively, copy your authentication token from [your Dart profile](https://app.itsdart.com/?settings=account) and save that as the `DART_TOKEN` environment variable.
 
 Then, you can run something like
+
 ```python
 import os
 from dart import create_task, is_logged_in, update_task
@@ -114,18 +147,17 @@ new_task = create_task(
 update_task(new_task.id, status_title="Done")
 ```
 
-
 ## Using the Python Library in AWS Lambda Functions
 
 To use the `dart-tools` Python library in an AWS Lambda function, you need to package the library with your Lambda deployment package (see more details at [Working with .zip file archives for Python Lambda functions](https://docs.aws.amazon.com/lambda/latest/dg/python-package.html)). Follow these steps:
 
-1. Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.
+### Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.
 
   ```sh
   cd my_function
   ```
 
-2. Create a Deployment Package
+### Create a Deployment Package
 
   Use Docker to create a deployment package that includes the `dart-tools` library. Run the following commands in your terminal, ensuring that the `RUNTIME_PYTHON_VERSION` and `RUNTIME_ARCHITECTURE` environment variables match the runtime settings of your Lambda function:
 
@@ -137,7 +169,7 @@ To use the `dart-tools` Python library in an AWS Lambda function, you need to pa
 
   This command installs the `dart-tools` library into a directory named `package` in your current working directory.
 
-3. Zip the contents of the `package` directory along with your `lambda_function.py`
+### Zip the contents of the `package` directory along with your `lambda_function.py`
 
   ```sh
   cd package
@@ -146,16 +178,15 @@ To use the `dart-tools` Python library in an AWS Lambda function, you need to pa
   zip -r my_deployment_package.zip lambda_function.py
   ```
 
-4. Deploy the Lambda function
+### Deploy the Lambda function
 
   Upload the `my_deployment_package.zip` file to AWS Lambda using the AWS Management Console or the AWS CLI.
 
 By following these steps, you can use the `dart-tools` Python library within your AWS Lambda functions.
 
-
 ## Help and Resources
 
-- [Homepage](https://www.itsdart.com/?nr=1)
+- [Homepage](https://itsdart.com/?nr=1)
 - [Web App](https://app.itsdart.com/)
 - [Help Center](https://help.itsdart.com/)
 - [Bugs and Features](https://app.itsdart.com/p/r/JFyPnhL9En61)

{dart_tools-0.7.0 → dart_tools-0.7.1}/pyproject.toml

@@ -1,11 +1,10 @@
 [project]
 name = "dart-tools"
-version = "0.7.0"
+version = "0.7.1"
 description = "The Dart CLI and Python Library"
 readme = "README.md"
 requires-python = ">=3.9"
-
-license = "MIT"
+license = {file = "LICENSE"}
 keywords = ["dart", "cli", "projectmanagement", "taskmanagement"]
 authors = [
   { name="Dart", email="software@itsdart.com" }
@@ -14,6 +13,7 @@ classifiers=[
     "Development Status :: 4 - Beta",
     "Environment :: Console",
     "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
     "Natural Language :: English",
     "Operating System :: OS Independent",
     "Programming Language :: Python",