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

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: dart-tools
-Version: 0.5.4
+Version: 0.6.11
 Summary: The Dart CLI and Python Library
 Author-email: Dart Software Team <software@itsdart.com>
 License: MIT License
@@ -27,7 +27,7 @@ License: MIT License
         
 Project-URL: Homepage, https://www.itsdart.com/?nr=1
 Project-URL: Web App, https://app.itsdart.com/
-Project-URL: Help Center, https://its-dart.notion.site/Dart-Help-Center-8206a2aa2956496f8988b7b32cdcd205
+Project-URL: Help Center, https://help.itsdart.com/
 Project-URL: Bugs and Features, https://github.com/its-dart/dart-tools/issues
 Project-URL: Library Source, https://github.com/its-dart/dart-tools/
 Keywords: dart,cli,projectmanagement,taskmanagement
@@ -40,24 +40,26 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Office/Business
 Classifier: Topic :: Office/Business :: Groupware
 Classifier: Topic :: Office/Business :: Scheduling
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: attrs
 Requires-Dist: dateparser
+Requires-Dist: httpx
 Requires-Dist: pick
-Requires-Dist: requests
 Requires-Dist: platformdirs
+Requires-Dist: requests
 
 <div align="center">
   <h1>Dart Tools</h1>
@@ -73,6 +75,14 @@ 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)
+- [Using the Python Library in AWS Lambda Functions](#using-the-python-library-in-aws-lambda-functions)
+- [Advanced Usage](#advanced-usage)
+- [Help and Resources](#help-and-resources)
+
+
 ## Setup
 
 In the terminal, install by running
@@ -105,7 +115,7 @@ This command will mark the referenced task 'Done'. Here `[DUID]` is meant to be
 
 ## Using the Python Library
 
-First, set up authentication. Run `dart login` in the terminal for an interactive process, or visit [your Dart profile](https://app.itsdart.com/?settings=profile) and then run `dart.login(token)` or save the token into the `DART_TOKEN` environment variable.
+First, set up authentication. Run `dart login` in the terminal for an interactive process, or visit [your Dart profile](https://app.itsdart.com/?settings=account) and then run `dart.login(token)` or save the token into the `DART_TOKEN` environment variable.
 
 Then, you can run something like
 ```python
@@ -125,6 +135,42 @@ new_task = create_task(
 update_task(new_task.duid, 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`.
+
+  ```bash
+  cd my_function
+  ```
+
+2. 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:
+
+  ```bash
+  export RUNTIME_PYTHON_VERSION=3.12
+  export RUNTIME_ARCHITECTURE=x86_64
+  docker run --rm --volume ${PWD}:/app --entrypoint /bin/bash public.ecr.aws/lambda/python:${RUNTIME_PYTHON_VERSION}-${RUNTIME_ARCHITECTURE} -c "pip install --target /app/package dart-tools"
+  ```
+
+  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`
+
+  ```bash
+  cd package
+  zip -r ../my_deployment_package.zip .
+  cd ..
+  zip -r my_deployment_package.zip lambda_function.py
+  ```
+
+4. 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.
 
 ## Advanced Usage
 
@@ -159,7 +205,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)
 ```
 
@@ -168,7 +214,7 @@ response = dart.transact([task_update_op], TransactionKind.TASK_UPDATE)
 
 - [Homepage](https://www.itsdart.com/?nr=1)
 - [Web App](https://app.itsdart.com/)
-- [Help Center](https://its-dart.notion.site/Dart-Help-Center-8206a2aa2956496f8988b7b32cdcd205)
+- [Help Center](https://help.itsdart.com/)
 - [Bugs and Features](https://github.com/its-dart/dart-tools/issues)
 - [Library Source](https://github.com/its-dart/dart-tools/)
 - [Chat on Discord](https://discord.gg/RExv8jEkSh)

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

@@ -12,6 +12,14 @@
 `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)
+- [Using the Python Library in AWS Lambda Functions](#using-the-python-library-in-aws-lambda-functions)
+- [Advanced Usage](#advanced-usage)
+- [Help and Resources](#help-and-resources)
+
+
 ## Setup
 
 In the terminal, install by running
@@ -44,7 +52,7 @@ This command will mark the referenced task 'Done'. Here `[DUID]` is meant to be
 
 ## Using the Python Library
 
-First, set up authentication. Run `dart login` in the terminal for an interactive process, or visit [your Dart profile](https://app.itsdart.com/?settings=profile) and then run `dart.login(token)` or save the token into the `DART_TOKEN` environment variable.
+First, set up authentication. Run `dart login` in the terminal for an interactive process, or visit [your Dart profile](https://app.itsdart.com/?settings=account) and then run `dart.login(token)` or save the token into the `DART_TOKEN` environment variable.
 
 Then, you can run something like
 ```python
@@ -64,6 +72,42 @@ new_task = create_task(
 update_task(new_task.duid, 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`.
+
+  ```bash
+  cd my_function
+  ```
+
+2. 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:
+
+  ```bash
+  export RUNTIME_PYTHON_VERSION=3.12
+  export RUNTIME_ARCHITECTURE=x86_64
+  docker run --rm --volume ${PWD}:/app --entrypoint /bin/bash public.ecr.aws/lambda/python:${RUNTIME_PYTHON_VERSION}-${RUNTIME_ARCHITECTURE} -c "pip install --target /app/package dart-tools"
+  ```
+
+  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`
+
+  ```bash
+  cd package
+  zip -r ../my_deployment_package.zip .
+  cd ..
+  zip -r my_deployment_package.zip lambda_function.py
+  ```
+
+4. 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.
 
 ## Advanced Usage
 
@@ -98,7 +142,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)
 ```
 
@@ -107,7 +151,7 @@ response = dart.transact([task_update_op], TransactionKind.TASK_UPDATE)
 
 - [Homepage](https://www.itsdart.com/?nr=1)
 - [Web App](https://app.itsdart.com/)
-- [Help Center](https://its-dart.notion.site/Dart-Help-Center-8206a2aa2956496f8988b7b32cdcd205)
+- [Help Center](https://help.itsdart.com/)
 - [Bugs and Features](https://github.com/its-dart/dart-tools/issues)
 - [Library Source](https://github.com/its-dart/dart-tools/)
 - [Chat on Discord](https://discord.gg/RExv8jEkSh)

{dart-tools-0.5.4 → dart_tools-0.6.11}/dart/__init__.py

@@ -1,13 +1,20 @@
+# Required for type hinting compatibility when using Python 3.9
+from __future__ import annotations
 from .generated.models import *
 from .dart import (
     Dart,
+    begin_task,
     cli,
-    set_host,
+    create_task,
+    get_dartboards,
+    get_folders,
+    get_host,
     is_logged_in,
     login,
-    create_task,
-    update_task,
-    begin_task,
     replicate_space,
+    set_host,
+    update_dartboard,
+    update_folder,
+    update_task,
 )
 from .webhook import is_signature_correct