A Python library for working with the Trello api.
Project description
Meet Trollop
Trollop is a Python library for working with the Trello API.
Quick Start
A Trello connection is instantiated with your API key and a user’s oauth token:
In [1]: from trollop import TrelloConnection In [2]: conn = TrelloConnection(<your developer key>, <user's oauth token>)
The connection object will automatically have a Member object attached, representing the user whose oauth token was used to connect:
In [3]: conn.me Out[3]: <trollop.lib.Member object at 0x101707650> In [4]: conn.me.username Out[4]: u'btubbs'
In the previous example no HTTP request was made until command 4, the access to conn.me.username. Trollop objects are lazy.
The connection object has methods for getting objects by their IDs:
In [5]: card = conn.get_card('4f2e454cefab2bbd4ea71b02') In [6]: card.name Out[6]: u'Build a Python Trello Library' In [7]: card.desc Out[7]: u'And call it Trollop.'
There are convenience properties to automatically look up related objects:
In [9]: lst = card.list In [10]: lst Out[10]: <trollop.lib.List object at 0x101707890> In [11]: lst.name Out[11]: u'Icebox' In [12]: lst.id Out[12]: u'4f17cb04d5c817032301c179' In [13]: len(lst.cards) Out[13]: 20 In [14]: lst.cards[-1].name Out[14]: u'Build a Python Trello Library'
Help Wanted
Coverage for creating/updating objects is still really thin. If you’d like to pitch in to finish covering the whole API, please send a pull request with your changes.
License
Trollop is licensed under the MIT License.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.