Python API wrapper around Trello's API

The methods below set due dates and add members. The Trello API does not list either actions officially but does support it it in the UI and both worked in my production environment. set_checklist_item_due() set_checklist_item_member()

Traceback (most recent call last):
  File "scripts/trello_requirements.py", line 242, in <module>
    main()
  File "scripts/trello_requirements.py", line 238, in main
    args.dry_run, args.lookup_method, args.approver)
  File "scripts/trello_requirements.py", line 144, in get_trello_board_content
    tcards = board.get_cards()
  File "/var/lib/jenkins/workspace/trello-to-polarion-igulina/Polarion_Scripts/.venv/lib/python2.7/site-packages/trello/board.py", line 302, in get_cards
    return list([Card.from_json(self, json) for json in json_obj])
  File "/var/lib/jenkins/workspace/trello-to-polarion-igulina/Polarion_Scripts/.venv/lib/python2.7/site-packages/trello/card.py", line 157, in from_json
    card.customFields = CustomField.from_json_list(card, json_obj['customFieldItems'])
KeyError: 'customFieldItems'

Error:

File "/usr/local/lib/python3.4/dist-packages/trello/compat.py", line 13, in force_str if PY2 and isinstance(s, unicode): # noqa NameError: name 'unicode' is not defined

when calling list_boards() on a TrelloClient instance.

Works fine in version 0.5.0 but breaks in 0.6.0.

Python version: 3.4.3 sys.version_info returns:

sys.version_info(major=3, minor=4, micro=3, releaselevel='final', serial=0)

When we talk about Python, one of the first things that comes to mind is PyPi, the great packages repository. This Trello wrapper is amazing but it's always outdated on PyPi vs here on Github. It would be amazing if the contributors could maintain both platforms up-to-date and aligned.

Forgive me if I am missing something but, from what I can tell, there is no way to update a board name. I can,

get the board with: my_board = client.get_board(board_id='someBoardId')

update the name with: my_board.name = "New Board Name"

But the save function is doing a POST rather than a PUT so the new name is not saved. my_board.save()

Shouldn't this functionality exist? https://developers.trello.com/advanced-reference/board#put-1-boards-board-id-name

Please let me know if I am just missing something.

Thanks!

Brandon Culpepper

In various places py-trello .encode('utf-8') some strings returned by the API.

What's the rationale behind this? Trello data is returned in JSON, with string keys and attributes in unicode strings (u'foo' in Python 2, 'foo' in Python 3).

Keeping unicode would make sense: in Python 2 you can compare bytestrings to unicode strings implicitly (u'foo' == 'foo'), but in Python 3 it'd make more sense to compare e.g. board.name to unicode strings instead of bytestrings. In Python 3 our code needs to re-decode data for comparison or string formatting. We have things like:

if board.name == b'Board name'

or:

message = '{}: {}'.format(board.name.decode(), card.name.decode())

My suggested fix would be to remove all occurrences of .encode('utf-8') here, to have a proper unicode sandwich behavior. Any objections? I'm happy to submit a PR.

I stumbled upon this while writing a backup script. For a copied card, everything that I wanted was there, except for the comments. It seems the action is different in that situation.

Some test output, prior this change:

### Sample Card

2019-05-07T16:00:00.000Z

Sample description

1 checklists
1 comments
1 attachments

### Copied Card

2019-05-07T16:00:00.000Z

Sample description

1 checklists
0 comments
1 attachments

After, the 0 comments becomes 1 comments.

As enhancement for the new custom field functionality I added a new function for getting a proper custom field instance for a specific card - only by specifying the custom field name.

Examples: cf = card_obj.get_custom_field_by_name('MyText') cf.value = u'This is my test text' cf = card_obj.get_custom_field_by_name('MyBool') cf.value = True

When I run an example list test40_add_card() in test_trello.py, I have no trouble calling add_card() on a list object, however, if I get a card in a different way, then it looks like the client attribute isn't initialized correctly. My usage is a bit convoluted, namely because I don't see a way to fetch a card by its ID or its name, but: b = trello.get_board('myboard') for card in b.get_cards(myfilter): if card == desired_card: l = trello.get_list(card.idList) l.add_card(cardname, 'delete me')

gives me the AttributeError. The documentation is a little sparse but am I expected to initialize objects in a certain order or ... ?

Ultimately I'm trying to implement a List.copy_card() method to create a new card from a template in a given list.

If a card has labels a list of <Label> is returned, but if it has none, None is returned. Why? It would seem preferable to me to return an empty list, since this

• doesn't break things that depend on a list (ie iterating a card's labels)
• better represents the actual labels on a card (an empty set of lables, which is different from nothing)

Hi, it seems Trello package cannot be imported when using Python 3.5.

urllib package has been updated, now 'quote_plus' is in urllib.parse

import trello Traceback (most recent call last): File "", line 1, in File "~\Anaconda3\envs\trello\lib\site-packages\trello_init_.py", line 1, in from urllib import quote_plus ImportError: cannot import name 'quote_plus'

This init.py file should be updated; line 1 changed to:

from urllib.parse import quote_plus

It seems that the Trello payload has changed when accessing cards data. The status of checklist items is not factorized in a checkItemStates section anymore but directly attached to them as a "state" attribute.

Attempting to access a card's checklist raises the following stack trace:

File "C:\virtualenvs\py-trello\lib\site-packages\trello\card.py", line 83, in checklists
    self._checklists = self.fetch_checklists()
  File "C:\virtualenvs\py-trello\lib\site-packages\trello\card.py", line 259, in fetch_checklists
    checklists.append(Checklist(self.client, self.checked, cl,
  File "C:\virtualenvs\py-trello\lib\site-packages\trello\checklist.py", line 22, in __init__
    for cis in checked:
TypeError: 'NoneType' object is not iterable

The Trello API offers a cover property for cards (see docs), but it is not being loaded into the Card object here.

It should be simple to at least "get" the property.

Workaround I'm using for now (might be useful to someone else):

def get_cover(card: 'Card') -> dict:
    """Gets the card's cover."""
    return card.client.fetch_json(f'/cards/{card.id}/cover')

I'm aware that there is a way to get the due date of a card from card.due_date, but is there any way to get the start date of a card? Or any plans for implementing this?

The Trello API has changed the way they control access to attachments, e.g. a card image. Previously, you could just do an unauthenticated GET to the attachment URL and be done with it. Now, you have to get a token that is valid for 1 hour.

This Python package should implement some functionality to help download these attachments more easily. Like maybe attachment.get_authenticated_download_url() using the credentials already present in the TrelloClient object.

Please see this announcement and this thread.