Project

trellish

0.0
No commit activity in last 3 years
No release in over 3 years
Create a pull request, put link to it on the card, remove everyone and move the card to the QA list
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 0.7.0
>= 1.9.1
 Project Readme

Trellish

Trellish is used to start and finish a Trello card. It does everything necessary to move a development card from "Next up" to "In Progress" when you start work on a card and again from "In Progress" to "QA" when you finish a card.

Installation

Add this line to your application's Gemfile:

gem 'trellish'

And then execute:

$ bundle

Or install it yourself as:

$ gem install trellish

Setup

Create a ./trellish.yml, ~/trellish.yml or ~/.trellish file with the contents of trellish.example.yml. Set it up like this:

  1. Sign in to Trello and go to https://trello.com/1/appKey/generate.
  2. Copy "Key" from that page to trello_api_key.
  3. Copy "Secret (for OAuth signing)" from that page to trello_oauth_secret.
  4. Visit https://trello.com/1/authorize?key=TRELLO\_API\_KEY\_FROM\_ABOVE&name=Trellish&expiration=never&response_type=token&scope=read,write
  5. Copy the token to trello_oauth_token.
  6. Run: curl -u 'username' -d '{"scopes":["repo"],"note":"Trellish"}' https://api.github.com/authorizations
  7. Copy the token parameter from the response to github_oauth_token.

Optionally, Trellish can announce the starting and finishing of cards on 37signal's Campfire. To enable this:

  1. Sign in to Campfire and go to your "my info" page. You can find the link in the upper-right corner.
  2. Copy your subdomain name to campfire_subdomain.
  3. Copy your API authentication token to campfire_token.
  4. Specify the room name in campfire_room.

Usage

By default, Trellish expects a Trello board named Current with 3 lists: Next up, In progress, and QA. You can change these defaults using the Trellish config file.

To start work on a card:

trellish start [Trello card id or URL]

This will:

  • move the card from Next up to In progress,
  • add you as a member,
  • create a local git branch named using your git initials and the card's title.

If you don't provide a card id or URL on the command line, trellish shows you the cards in Next up and prompts you to select one, like so:

Select a card:
1. BUG: crash adding a comment
2. users can select an avatar
3. add iPad integration tests
>

When you're done working on a card, finish it using:

trellish finish [Trello card id or URL]

Like:

trellish finish https://trello.com/c/a3Wbcde4
trellish finish a3Wbcde4
trellish finish

This will:

  • create a pull request to merge your topic branch into master (with a description linking back to the card)
  • add a link to the pull request from the card's description
  • remove everyone from the card
  • move the card to the QA list

Certificate issues

If you're stuck with an error along the lines of

SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed

try updating your root certificates. If you use RVM, this may work:

curl http://curl.haxx.se/ca/cacert.pem -o ~/.rvm/usr/ssl/cert.pem

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request