Skip to main content

The Dart CLI and Python Library

Project description

Dart Tools

PyPI Supported Python Versions License

Dart is Project Management powered by AI.

dart-tools is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python.

Setup

In the terminal, install by running

pip install dart-tools

Using the CLI

As an example, start off by logging in with

dart login

Then, you can create a new task with a command along the lines of

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.

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

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'.

Using the Python Library

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
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
new_task = create_task(
    "Update the landing page", priority_int=0, tag_titles=["marketing"]
)

# update the task to be 'Done'
update_task(new_task.duid, status_title="Done")

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. For most advanced usage, the best thing to do is to get in touch with us and we can help.

However, if you want to explore on your own, the client is well-typed, so you can simply explore the code to see what is possible. All updates will go through the the dart.transact function.

As an example, you could run something akin to update_task with

from dart import (
    Dart,
    Operation,
    OperationKind,
    OperationModelKind,
    TaskUpdate,
    TransactionKind,
)

# initialize the inner client
dart = Dart()

# prepare the update operation
task_update = TaskUpdate(
    duid="[DUID]",
    size=5,
)
task_update_op = Operation(
    model=OperationModelKind.TASK,
    kind=OperationKind.UPDATE,
    data=task_update,
)

# call the operation transactionally to preform the update
response = dart.transact([task_update_op], TransactionKind.TASK_UPDATE)

Help and Resources

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dart-tools-0.4.2.tar.gz (77.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page