YTrello

Tools to help with the YaST Trello boards.

• Make cards for bugs in Bugzilla.suse.com

Requirements

• bicho.gem >= 0.0.10
• ruby-trello.gem
• python-bugzilla >= 2.1.0

Installation

From a Git checkout:

sudo zypper install python-bugzilla
bundle install
alias ytrello="bundle exec ytrello"

From Rubygems:

sudo zypper install python-bugzilla
gem install ytrello

From OBS, this selects the appropriate Ruby version:

zypper install -C 'rubygem(ytrello)'

Setup

ruby-trello reads the configuration file ~/.config/trello-creds.yml:

• The Developer Public Key is the first hex string on https://trello.com/app-key

F=~/.config/trello-creds.yml`
touch $F
chmod 700 $F
echo "# https://github.com/mvidner/ytrello" >> $F
echo "TRELLO_DEVELOPER_PUBLIC_KEY: replaceme" >> $F
vi $F

After you fill in the developer key, use this to request an app token, then copy the generated token to the config file.

xdg-open "https://trello.com/1/authorize?key=REPLACEME&name=ytrello&expiration=never&response_type=token&scope=read,write"
echo "TRELLO_MEMBER_TOKEN: replaceme" >>$F
vi $F

For backward compatibility, the environment variables TRELLO_DEVELOPER_PUBLIC_KEY and TRELLO_MEMBER_TOKEN are respected, and even preferred over the configuration file.

bicho and python-bugzilla read ~/.oscrc so if you have used osc it should work already.

Usage

• create

ytrello create $BUG_NUMBER

• addurl is normally called by create, but in case you want to use it directly, it is straightforward. It will assign the URL field of a bug unless the field is already present.

ytrello addurl 999999 https://trello.example.com/cards/my-first-card

• check runs some validation checks and reports the found issues:

  • It checks whether the YaST team bugs have a link to a Trello card (in the URL field).
  • It checks that all open YaST team bugs are tracked in Trello (i.e. a card exists).
  • Reports the Trello cards which refer to a closed bug in bugzilla. These cards should be moved to Done or archived if the bug is not valid anymore.

The command supports a simple auto correction mode. In this mode it tries to fix the found issues. Use -a or --auto-correct option to turn it on (by default it is disabled).

Currently these auto correct actions are performed:

• The missing links from Bugzilla bugs to the Trello cards are added.
• Missing Trello cards are created

It is recommended to run it in read-only mode first to see the found issues:

  ytrello check

If the reported changes are valid you can fix them by running:

  ytrello check -a