A reusable Django app that helps connection Freckle time entries with Trello cards.
On Freckle, when you track time that has been spent on a certain card, just add cXXX to the entry description, where XXX is the card-ID from Trello (you can see that in the URL when you open a card).
For more information, see chapter Usage below.
Installation
To get the latest stable release from PyPi
pip install django-trello-freckle-sprintsTo get the latest commit from GitHub
pip install -e git+git://github.com/bitmazk/django-trello-freckle-sprints.git#egg=sprintsAdd sprints to your INSTALLED_APPS
INSTALLED_APPS = (
...,
'sprints',
)Add the sprints URLs to your urls.py
urlpatterns = [
url(r'^sprints/', include('sprints.urls')),
]Settings
TRELLO_DEVELOPER_KEY
Set this to your [Trello developer key](https://trello.com/1/appKey/generate).
TRELLO_DEVELOPER_SECRET
Set this to your [Trello developer secret](https://trello.com/1/appKey/generate).
TRELLO_OAUTH_TOKEN
TODO: Describe how to get the tokens
Set this to your oauth token. To obtain your secret you can run ipdb:
from trello.util import create_oauth_token create_oauth_token(expiration='never', scope='read', key='yourkey', secret='yoursecret') # follow the instructions and note down your token and secret
TRELLO_OAUTH_TOKEN_SECRET
Set this to your oauth token secret.
FRECKLE_API_TOKEN
Set this to your Freckle API token. You can find it under Settings > API.
FRECKLE_ACCOUNT_NAME
Set this to your Freckle account name. This is the subdomain you use when logging into Freckle.
Usage
Sprint planning
To get an overview over your current backlog, visit /sprints/backlog/. Enter the Trello board ID, the lists numbers that contain your backlog and your hourly rate.
You will see a table that shows the estimated time and cost for each card in the selected lists. The total will give you an idea about how expensive the whole project will be in total, given the current feature scope.
In order to plan your next sprint, enable the checkboxes next to each card until the selected total matches the budget or hours that you can spend on the sprint.
Sprint overview
To get an overview over a sprint, visit /sprints/sprint/.
TODO: Explain more
Contribute
If you want to contribute to this project, please perform the following steps
# Fork this repository
# Clone your fork
mkvirtualenv -p python2.7 django-trello-freckle-sprints
make develop
git co -b feature_branch master
# Implement your feature and tests
git add . && git commit
git push -u origin feature_branch
# Send us a pull request for your feature branch3 maintainers
Metadata
3 maintainers
Release files for django-trello-freckle-sprints 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| django-trello-freckle-sprints-0.1.1.tar.gz | 73.0 kB | Details |
Release files / django-trello-freckle-sprints-0.1.1.tar.gz
| Download URL | django-trello-freckle-sprints-0.1.1.tar.gz |
|---|---|
| Size | 73.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
09b2c9eba872022e1e547aac3f31a5e3cfa587264b24cc2c74c9c62b4aac08e0
|
|
BLAKE2b-256 checksum How to use checksums |
65d78d476d18c264acb853c497858d6fdd2963cade26b38e7ae337b0aab85f6b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
