Imported from Bitbucket
5c935d70a77e — Gustavo Andres Morero default tip 3 years ago
fixing boards and organizations update methods.
87480b9b423f — Ben McCormack 8 years ago
Updated Trello API.
ca51a068a2a8 — Ben McCormack 8 years ago
pystache removed support for pystache.View in future versions. Add note about using earlier version of pystache for the time being so that we can generate the API.

heads

tip
browse log

clone

read-only
https://hg.code.netlandish.com/~netlandish/trellopy
read/write
ssh://hg@hg.code.netlandish.com/~netlandish/trellopy

Python Trello API Wrapper =========================

This Python API is simply a wrapper around the Trello REST API. It uses the API documentation to autogenerate the Python API.

This repository contains the latest generated version of the Python API (in the trello directory), along with the necessary files to regenerate the API.

Getting Started


To use the Python API, first install it from PyPI using pip:

pip install trello

or from source:

python setup.py install

Once you have it installed, get an app key from https://trello.com/1/appKey/generate. It will be a 32-digit hex string. Now you can start using the API

>>> from trello import TrelloApi
>>> trello = TrelloApi(TRELLO_APP_KEY)
>>> trello.boards.get('4d5ea62fd76aa1136000000c')
{
    "closed": false, 
    "desc": "Trello board used by the Trello team to track work on Trello.  How meta!\n\nThe development of the Trello API is being tracked at https://trello.com/api\n\nThe development of Trello Mobile applications is being tracked at https://trello.com/mobile", 
    "id": "4d5ea62fd76aa1136000000c", 
    "idOrganization": "4e1452614e4b8698470000e0", 
    "name": "Trello Development", 
    "pinned": true, 
    "prefs": {
        "comments": "public", 
        "invitations": "members", 
        "permissionLevel": "public", 
        "voting": "public"
    }, 
    "url": "https://trello.com/board/trello-development/4d5ea62fd76aa1136000000c"
}

Because the Trello development board is public, we didn't need a user's token, but if we want to access private boards, we'll have to have one. We can get it by calling:

>>> trello.get_token_url('My App', expires='30days', write_access=True)
    'https://trello.com/1/authorize?key=TRELLO_APP_KEY&name=My+App&expiration=30days&response_type=token&scope=read,write'

If you send your user to the resulting URL, it will ask them to allow your app access to their account, and then it will give them a token (64-digit hex string) that they will pass back to your app.

>>> trello.set_token(user_token)

(Note: Trello does support OAuth, but the Python API does not have any support for it yet.)

Once you have set the user's token, all calls to the API will include that token, as if the user was logged in.