Skip to main content

Django Bitbucket & Trello Integration

Project description


The main goal is to develop a standalone application that can seamlessly integrate Bitbucket and Trello. It can be further divided into smaller goals which are the following:

  • Define a staging branch that can trigger a specific Trello card to move to another specified Trello list (e.g. Testing)

  • Define a production branch that can trigger a specific Trello card to move to another specified Trello list (e.g. Done)

  • Any Trello card mentions following pattern #<card_number> in a commit message shall be added to the corresponding card as a comment

  • Keep application architecture flexible for better maintainability

  • Easy initial setup, such as API authorization, application settings

  • Add Power-Up for Trello in the future


Here’s some history background. We use Bitbucket as a code repository and we have recently switched to Trello as part of Agile methodology. Basically our team consists of developers and a QA team (testers).

Our development process works the following way. The project owner lays down a number of Trello cards in, let’s say, To Do list that are primary goals of our project that we have to complete. Developers pick them up one by one and move them onto Doing list, create a branch and start working on it. Once we complete a task, we push it to Bitbucket repository, merge it to the staging branch and manually move a corresponding Trello card from Doing list onto Testing list.

That’s when testers come into play. They test a feature and when it has no issues they move it from Testing onto Done. Upon that we, developers, get a notification from Trello and then we go to Bitbucket and create new pull request, then merge it to the production branch.

It’s obvious that moving cards here and there is much of a hassle and takes up a lot of our time that we could spend on actual development. There were other online Kanban boards that had integration with Bitbucket of course, but we really like Trello due to its simplicity and user-friendliness. We couldn’t find any free solution on Internet either that would integrate Trello and Bitbucket. Then I decided to create it on my own.


I assume that you already have an app server, Bitbucket repository for your project and a Trello board. In order to use this application you need to get some stuff in your hand first. First of all, you need to get a token and an app key from here. Secondly, make sure you get an ID of the lists you are about to use; you may get them through their API by passing a board ID.

Once you acquire a token and an app key, think of a flow that you will have, meaning properly naming branches and Trello lists. As for us, our staging branch is called master, which is the latest but unstable, and our production branch is called production, which might be the latest but it’s stable. Our Trello list are as follows: To Do -> Doing -> Testing -> Done.

You may also visit <> for more information.


In your terminal:

pip install django-bitbucket-trello

Then just copy the code below into your settings file and make sure that you change these settings according to your project:

# Bitbucket settings.

PRODUCTION_BRANCH = 'production'


# Trello authorization.
TRELLO_TOKEN = '407b6d302c149af0f247850582a63463dbaf4dbd190bc4458cab5f68e4f25b'

TRELLO_KEY = '7eec0a9c1bc1f78dq6df5de55c7e414df'

# Trello settings.
BOARD_ID = '58255f33bb08fbfc0bebf473'

PRODUCTION_LIST_ID = '57b4347044f46a061626eb55'

STAGING_LIST_ID = '57b4346f602c21c635ebe0ds'

CARD_POSITION_UPON_MOVING = 'top'  # 'top', 'bottom' or a positive integer

# Integration parameters.



How To Use

In your

from django.conf.urls import patterns, include, url
from bitbucket_trello import ReceiverView

urlpatterns = patterns('',
    url(r'^bitbucket-webhooks/$', ReceiverView.as_view(), name='bitbucket_webhooks'),

Then go to Bitbucket settings -> Webhooks and point to this URL.

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

django-bitbucket-trello-0.0.8.tar.gz (5.5 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