dart-tools 0.6.11__py3-none-any.whl → 0.6.13__py3-none-any.whl

{dart_tools-0.6.11.dist-info → dart_tools-0.6.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: dart-tools
-Version: 0.6.11
+Version: 0.6.13
 Summary: The Dart CLI and Python Library
 Author-email: Dart Software Team <software@itsdart.com>
 License: MIT License
@@ -64,8 +64,8 @@ Requires-Dist: requests
 <div align="center">
   <h1>Dart Tools</h1>
   <p>
-    <a href="https://pypi.org/project/dart-tools"><img src="https://img.shields.io/pypi/v/dart-tools.svg" alt="PyPI"></a>
-    <a href="tox.ini"><img src="https://img.shields.io/pypi/pyversions/dart-tools" alt="Supported Python Versions"></a>
+    <a href="https://pypi.org/project/dart-tools"><img src="https://img.shields.io/pypi/v/dart-tools" alt="PyPI"></a>
+    <a href="pyproject.toml"><img src="https://img.shields.io/pypi/pyversions/dart-tools" alt="Supported Python Versions"></a>
     <a href="LICENSE"><img src="https://img.shields.io/github/license/its-dart/dart-tools" alt="License"></a>
   </p>
 </div>
@@ -75,31 +75,35 @@ Requires-Dist: requests
 `dart-tools` is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python.
 
 
-- [Setup](#setup)
+- [Installation](#installation)
 - [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)
+  - [In AWS Lambda Functions](#in-aws-lambda-functions)
 - [Advanced Usage](#advanced-usage)
 - [Help and Resources](#help-and-resources)
+- [Contributing](#contributing)
+- [License](#license)
 
 
-## Setup
+<a name="installation"></a>
+## Installation
 
 In the terminal, install by running
-```bash
+```sh
 pip install dart-tools
 ```
 
 
+<a name="using-the-cli"></a>
 ## Using the CLI
 
 Start off by setting up authentication with
-```bash
+```sh
 dart login
 ```
 
 Then, you can create a new task with a command along the lines of
-```bash
+```sh
 dart createtask "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.
@@ -107,12 +111,13 @@ which will make a new task called 'Update the landing page' with priority 'Criti
 You can explore all of these options and many more with `dart --help` or the more specific help for subcommands, in this case `dart createtask --help`.
 
 Another common workflow is to updating a preexisting task. To do this, run something like
-```bash
+```sh
 dart updatetask [DUID] -s Done
 ```
 This command will mark the referenced task 'Done'. Here `[DUID]` is meant to be replaced (including the brackets) with the 'Dart ID' of an existing task. You can get a DUID 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'.
 
 
+<a name="using-the-python-library"></a>
 ## 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=account) and then run `dart.login(token)` or save the token into the `DART_TOKEN` environment variable.
@@ -125,8 +130,7 @@ from dart import create_task, is_logged_in, update_task
 # Check that auth is set up and stop if not, can remove this once everything is set up
 is_logged_in(should_raise=True)
 
-# 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"]
 )
@@ -135,13 +139,15 @@ new_task = create_task(
 update_task(new_task.duid, status_title="Done")
 ```
 
-## Using the Python Library in AWS Lambda Functions
+
+<a name="in-aws-lambda-functions"></a>
+### 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
+  ```sh
   cd my_function
   ```
 
@@ -149,7 +155,7 @@ To use the `dart-tools` Python library in an AWS Lambda function, you need to pa
 
   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
+  ```sh
   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"
@@ -159,7 +165,7 @@ To use the `dart-tools` Python library in an AWS Lambda function, you need to pa
 
 3. Zip the contents of the `package` directory along with your `lambda_function.py`
 
-  ```bash
+  ```sh
   cd package
   zip -r ../my_deployment_package.zip .
   cd ..
@@ -172,6 +178,8 @@ To use the `dart-tools` Python library in an AWS Lambda function, you need to pa
 
 By following these steps, you can use the `dart-tools` Python library within your AWS Lambda functions.
 
+
+<a name="advanced-usage"></a>
 ## Advanced Usage
 
 Almost anything that can be done in Dart can be done with the Python library, but there are not convenient wrapper functions for everything.
@@ -210,12 +218,25 @@ response = dart.transact([task_update_op], TransactionKind.TASK_UPDATE)
 ```
 
 
+<a name="help-and-resources"></a>
 ## Help and Resources
 
 - [Homepage](https://www.itsdart.com/?nr=1)
 - [Web App](https://app.itsdart.com/)
 - [Help Center](https://help.itsdart.com/)
-- [Bugs and Features](https://github.com/its-dart/dart-tools/issues)
+- [Bugs and Features](https://app.itsdart.com/p/r/JFyPnhL9En61)
 - [Library Source](https://github.com/its-dart/dart-tools/)
 - [Chat on Discord](https://discord.gg/RExv8jEkSh)
 - Email us at [support@itsdart.com](mailto:support@itsdart.com)
+
+
+<a name="contributing"></a>
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+
+<a name="license"></a>
+## License
+
+This project is licensed under [the MIT License](LICENSE).

{dart_tools-0.6.11.dist-info → dart_tools-0.6.13.dist-info}/RECORD

@@ -248,10 +248,10 @@ dart/generated/models/webhook.py,sha256=90ZjBe-oh8hTQMb8CafWTZTUsaj9eHxu85uU-JxT
 dart/generated/models/webhook_create.py,sha256=kyhv-pI8i4URwul5Ive3hh7TirpDB1YQmio8tn0lkJo,1834
 dart/generated/models/webhook_update.py,sha256=iy9mx8yyKn9182td88pOnc2H7_4H8xl27m8tV3j8hEI,1916
 dart/generated/models/zapier_integration.py,sha256=3cKzM0UHNte6Jg-hnroOvgMUHiD7iv1fodrWZoAIaag,1783
-dart_tools-0.6.11.dist-info/dist/dart-tools-0.3.3.tar.gz,sha256=JHf6kKcFBOXsnB62lpeV3xcv-GVusi5CysY2tAxgxvk,8788
-dart_tools-0.6.11.dist-info/LICENSE,sha256=4ZrQkL_PyaBC3paDrqLnD3knKAXS2i8HwJGyUgRUxls,1061
-dart_tools-0.6.11.dist-info/METADATA,sha256=gk-u3-hww0XoZwZeRNSh2T9DtJKitTxqqjd6xWctuos,8904
-dart_tools-0.6.11.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-dart_tools-0.6.11.dist-info/entry_points.txt,sha256=KOVAnDWJbSKn9HoXWQ7x6NfACYzSMGHBBaBxonHEv6w,34
-dart_tools-0.6.11.dist-info/top_level.txt,sha256=ZwUQ6QjCyi1i32BJOAkbOA7UfgitLmIwToJGJwZXPrg,5
-dart_tools-0.6.11.dist-info/RECORD,,
+dart_tools-0.6.13.dist-info/dist/dart-tools-0.3.3.tar.gz,sha256=JHf6kKcFBOXsnB62lpeV3xcv-GVusi5CysY2tAxgxvk,8788
+dart_tools-0.6.13.dist-info/LICENSE,sha256=4ZrQkL_PyaBC3paDrqLnD3knKAXS2i8HwJGyUgRUxls,1061
+dart_tools-0.6.13.dist-info/METADATA,sha256=QWgpjR9T2gMbHuvB71SffA3AvQ-wS_q_TwnfzK7qrco,9308
+dart_tools-0.6.13.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+dart_tools-0.6.13.dist-info/entry_points.txt,sha256=KOVAnDWJbSKn9HoXWQ7x6NfACYzSMGHBBaBxonHEv6w,34
+dart_tools-0.6.13.dist-info/top_level.txt,sha256=ZwUQ6QjCyi1i32BJOAkbOA7UfgitLmIwToJGJwZXPrg,5
+dart_tools-0.6.13.dist-info/RECORD,,