Createcard

Creates a trello card and a github PR with the same title and links the URLS.

Prerequisites

• PHP >= 7.4
• Composer
• Github CLI

Installing

Run the following script:

./install.sh

It will install composer dependencies and copy config file templates to your local user. Be sure to fill in these configfiles with the required information such as API key etc.

Helpful links for installing

• You can find your Trello API key here
• You can find the names and ids of your board, members, lists etc by appending .json after your board url. (e.g https://trello.com/b/TTAVI7Ny/ue4-roadmap -> https://trello.com/b/TTAVI7Ny/ue4-roadmap.json)

Usage

Description:
  Creates a trello card and a github pr with the given title and crossconnects the urls

Usage:
  create-card [options] [--] <list> <title>

Arguments:
  list                           The list your card will be placed in <doing, review, test&deploy>
  title                          The title of your card / PR

Options:
  -l, --label=LABEL              Labels to add to the card (multiple values allowed)
  -m, --member=MEMBER            Members to assign to the card (multiple values allowed)
  -r, --reviewer=REVIEWER        Member to assign as reviewer
      --fyi=FYI                  Notify users with FYI (multiple values allowed)
  -d, --description=DESCRIPTION  Describe what you are trying to do
  -i, --description-interactive  Enter a description interactively via vim
  -h, --help                     Display help for the given command. When no command is given display help for the list command
  -q, --quiet                    Do not output any message
  -V, --version                  Display this application version
      --ansi                     Force ANSI output
      --no-ansi                  Disable ANSI output
  -n, --no-interaction           Do not ask any interactive question
  -v|vv|vvv, --verbose           Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Useful aliasses (ZSH/Bash)

Make your life easier and add an easy to remember alias to run this application. From now on examples will use these names.

(Make sure you double-check the paths)

# Createcard
alias cr="php ~/repo/createcard/createcard.php create-card "

# function to create a card and opening it in a new tab in firefox
crf ()
{
  OUTPUT=$(cr $@)

  [ $? -eq 0 ] && firefox --new-tab $OUTPUT || echo $OUTPUT
}
# End Createcard

Trello Aliases

By default all the names as on trello will be used as identifiers. However some of these name might be cumbersome to type. For instance lets say you want to apply a label Really Long Label My Man to your card.

You could use:
cr doing "descriptive title" -l "Really Long Label My Man"

But it's rather annoying isn't it?

Therefore, there is the option to make aliases for members, lists and labels.

How do I alias things?

1. Edit the trello alias yaml file in ~/.config/createcard/trello_alias.yml
2. Add alias: <Original Name> in the right block.

For instance if we wanted to add the incredibly intuitive alias rllmm for the label from our earlier example we could add it like so:

lists:

members:

labels:
  rllmm: Really Long Label My Man

Now we can use it like any other name (also the original label name will still work):
cr doing "descriptive title" -l rllmm