Yello
This CLI enables the import/export of Trello boards to and from YAML files.
Installation
gem install yello
Configuration
You will need to obtain a Trello API key and token. The CLI will walk you through this process if you run this:
yello login
Credentials will be stored in your netrc file. If you encrypt this file with GPG, your Trello credentials will also be encrypted. This functionality is brought to you courtesy of the netrc gem
Usage
Here is an example of the file format:
Not Started:
cards:
- Get an email account
- Have lunch with your manager
- Get a key card
- Attend the noob-101 workshop
# Shorthand for a simple checklist
checklist:
- item 1
- item 2
- Submit your first bugfix:
desc: You must fix a bug to prove your worth.
# Long form for if you need multiple checklists or custom names.
checklists:
- Process:
- Write tests
- Write code
- Get it reviewed
- Merge it
In Progress: {}
Completed: {}
Importing a file
Importing a file will create a new board in Trello with the name you specify.
# this ...
yello import --file /path/to/file.yml --share foo@bar.com "my awesome board"
# or this ...
cat /path/to/file.yml | yello import --share foo@bar.com "my awesome board"
Exporting a file
Exporting a board will generate yaml based on the given board from Trello. At present, only board IDs are supported when exporting.
# this ...
yello export --id TE7Kl7ua --file /path/to/file.yml
# or this ...
yello export --id TE7Kl7ua > /path/to/file.yml
Contributing
- Fork it ( https://github.com/[my-github-username]/yello/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request