Skip to main content

Python wrapper for the Toodledo v3 API which is documented at http://api.toodledo.com/3/

Project description

Overview

Python wrapper for the Toodledo v3 API which is documented at http://api.toodledo.com/3/. Available on PyPI at https://pypi.org/project/toodledo/.

This fork is being actively maintained by Jonathan Kamens <jik@kamens.us>. Changelogs of new releases are published on Github.

Thanks to Rehan Khwaja for creating this library.

Please support this project on Patreon.

Usage

If you’re using this library to build a web app that will be used by multiple people, you need to be familiar with how to use OAuth2 for authentication between your web app and Toodledo. Explaining how to do that is beyond the scope of this document.

To use the library, you need to register an app in your Toodledo account. This can be done at https://api.toodledo.com/3/account/doc_register.php. You will need the client ID and client secret for your app shown on the registration page to connect to the API.

If you’re using this library to build a private script you’re running yourself, you will probably want to use the CommandLineAuthorization function in the library to authenticate the first time. Something like this:

import os
from toodledo import TokenStorageFile, CommandLineAuthorization

tokenFilePath = "fill in path to token file"
clientId = "fill in your app client ID"
clientSecret = "fill in your app client secret"
scope = "basic tasks notes folders write"
tokenStorage = TokenStorageFile(tokenFilePath)

if not os.path.exists(tokenFilePath):
    CommandLineAuthorization(clientId, clientSecret, scope, tokenStorage)

It will prompt you to visit a URL, which will prompt you to log into Toodledo if you’re not already logged in, then click a “SIGN IN” button. The sign in will fail since you presumably specified a bogus redirect URL when registering the app, but you can then copy the failed URL from your browser back into the script to complete the authentication process.

Once you’ve authenticated, you create an API instance like this:

toodledo = Toodledo(
  clientId=clientId,
  clientSecret=clientSecret,
  tokenStorage=tokenStorage,
  scope=scope)

And here’s how you call the API:

account = toodledo.GetAccount()

allTasks = toodledo.GetTasks()

See the help messages on individual methods.

See also this more extensive example of using the API in a script.

Using the task cache

In addition to close-to-the-metal access to the API endpoints, this library also implements a TaskCache class that you can use to cache tasks persistently in a file which is updated incrementally when things change in Toodledo. Import the class and look at its help string for more information.

Developing the library

The library uses poetry for managing packages, building, and publishing. You can do poetry install at the top level of the source tree to install all of the needed dependencies to build and run the library. poetry build builds packages, and poetry publish publishes them to PyPI.

All the code in the library is both pylint and flake8 clean, and any PRs that are submitted should maintain that. Run poetry run pylint *.py tests toodledo and poetry run flake8 to check everything.

To run the tests, set the following environment variables:

Then generate the credentials json file by running

poetry run python generate-credentials.py

Then run the tests by executing

poetry run pytest

in the root directory.

Please ensure that all the tests pass in any PRs you submit.

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

toodledo-1.5.1.tar.gz (17.3 kB view details)

Uploaded Source

Built Distribution

toodledo-1.5.1-py3-none-any.whl (20.1 kB view details)

Uploaded Python 3

File details

Details for the file toodledo-1.5.1.tar.gz.

File metadata

  • Download URL: toodledo-1.5.1.tar.gz
  • Upload date:
  • Size: 17.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.11.7 Linux/6.5.0-5-amd64

File hashes

Hashes for toodledo-1.5.1.tar.gz
Algorithm Hash digest
SHA256 173aeb0cb2466627f67a1b2b3691c6e23b36ec51fa3166aa06e8c11e78a3773a
MD5 5e4360b080ecee4f914cd148c05a04a3
BLAKE2b-256 561767496011320e34f4aa1165e762b0e07e20257ad0073936895a34b48b7402

See more details on using hashes here.

File details

Details for the file toodledo-1.5.1-py3-none-any.whl.

File metadata

  • Download URL: toodledo-1.5.1-py3-none-any.whl
  • Upload date:
  • Size: 20.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.11.7 Linux/6.5.0-5-amd64

File hashes

Hashes for toodledo-1.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2a2e2fc2d9d773d166662b0e1d82c8185b6bb92fbed66d771e5e401ae9388aad
MD5 f2045da40f9474da578e5aa10ed08610
BLAKE2b-256 961164e91e02c9575f3456ad861a752f8012d5f7799a51a5c16bb17036330d91

See more details on using hashes here.

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