A trello release notes generator for node.js
You can install it using npm.
npm install trello-releasenotes
First, log in to Trello and open Generate API Keys. You'll receive an key to use in the next step.
Second, call https://trello.com/1/authorize?key=YOUR_KEY&name=trello-releasenotes&expiration=never&response_type=token to grant access for this application. Be sure to replace YOUR_KEY with the key received in the first step.
For further information visit: Getting a Token from a User
Store the key from the first action in setting applicationKey of settings.json and the token received from the second step in userToken.
There are some settings you can set up in settings.json:
applicationKey Insert your obtained application key from Trello to get access to it
userToken Define your user token you'll receive when obtaining an application ey
boardId Define the id of the board you want to search for release notes
releaseIdentifier Default is set to 'RELEASE:'
template Defines the template to use
exportLinks if true, links are written to the exported data; the default template is able to handle that
exportPath Set a path if release notes should be exported to a specific path
titleReplacePattern A replace regular expression to replace parts of the title (export)
strings These are used to create the export, translate them into your language if you want
versionandproductofstringsare used to generate the filename.
When you open your Trello account you get a list of boards, open one of it and the URL will be something like
https://trello.com/board/boardname/identifier
Copy identifier and set this one as the boardId in settings.json. This is used to search for lists if there is no command line option that overrides that setting.
To export release notes start it like shown bellow:
node index.js -g [LISTNAME(S)]
Replace [LISTNAME(S)] with the name of your list that contains the cards and release note for export. In this case the configured boardId from settings.json will be used to find the internal id of [LISTNAME(S)]. In case you have different boards, you can override the configured boardId by using the -b option.
node index.js -g [LISTNAME(S)] -b [BOARDID]
If you want to run a job updating your release notes it might be helpful to set the version by an parameter. This can be done by using the parameter -v.
node index.js -g [LISTNAME(S)] -b [BOARDID] -v [VERSION]
To export all release notes of list 'Done' execute
node index.js -g Done
It is also possible to export release notes of several lists. Call it like this:
node index.js -g "My List 1, My List 2"
This will search My List 1 and My List 2 for cards having release notes.
Please note that the result is a .markdown file that can be processed with other modules like ideamark or mdserv. In this combination you can directly serve your exported release notes via HTTP.
All cards of the given list having comments that start with RELEASE: (default) are exported. If there are multiple entries having this "flag", all of them are exported. You are able to change this setting in settings.json, change releaseIdentifier to a value you like to use.
Please note that all lists (also archived ones) are considered.
In some cases it is very helpful to view the lists available within the configured board. To get an overview use the option -l or --list:
node index.js -l
This will come up with a complete list, showing the status (open, closed), list id and the name. It's also possible to get a list of a specific status. This options are available:
node index.js -l all The same as -l without a parameter
node index.js -l open Shows all lists that are not archived.
node index.js -l closed Shows all archieved lists
It is also possible to use this module from another one. For example to receive all cards having release notes for the specified lists:
var TrelloReceiver = require('./lib/cardreceiver.js');
var lists = ["list1", "list2"];
var receiver = new TrelloReceiver("applicationKey", "userToken", "boardId");
receiver.receive(lists, function(err, cards) {
if (err) {
// handle error
}
// do something with your cards here
});
It's also possible to work with lists:
receiver.getLists(filter, function(error,data) {
if (error) {
console.log(error instanceof Error ? error.message : error);
} else {
if (data) {
for (var i = 0; i < data.length; i++) {
console.log((data[i].closed ? '[closed] ' : '[open] ') + data[i].id + ' ' + data[i].name);
}
}
}
});
The filter defines (if set) which lists to be received. Possible values based on the Trello API:
- none
- open
- closed
- all
trello-releasenotes uses Mu - a fast, streaming Node.js Mustache engine as the templating engine. Have a look at the documentation to get familiar with Mustache. A simple template (it's the default of trello-releasenotes):
# {{header}} {{product}}
{{version}} **{{version_number}}**
{{generated}} **{{date}}**
## {{subheader}}
{{#data}}
**{{name}}**
{{#labels}} `{{name}}` {{/labels}}
{{#releasenotes}}
> {{singleNote}}
{{/releasenotes}}
{{/data}}
{{^data}}
No release notes available!
{{/data}}
As you are able to configure the used templates within settings.json you can add new templates easily. Otherwise feel free to change the existing ones.
This is the available structure for templating:
{
"header": "",
"product": "",
"version": "",
"version_number": "",
"generated": "",
"date": "",
"subheader": "",
"data":
[
{
"name": "",
"labels": "",
"link": "",
"releasenotes":
[
{ "singleNote": "" }
]
}
]
}
data is an array of all found cards. releasenotes is an array of all release notes found for the card.
- Generation of HTML and PDF output
- Option to receive all lists for configured/specified board id
If there are bugs or ideas for this project please leave a ticket here.
This project is tested with Travis CI.
trello-releasenotes is licensed under MIT.
