| 1 | # standup-boy [](https://travis-ci.org/vikepic/standup-boy) [](https://github.com/xojs/xo)
|
| 2 |
|
| 3 | > A simple module to create daily standup texts :clock10:
|
| 4 |
|
| 5 | `standup-boy` helps you create daily standup texts fast and easy.
|
| 6 | It prompts you the usual stuff for a daily standup, then outputs a nicely-formatted, emoji-ready text for you to use in whatever platform you desire.
|
| 7 | Assumes markdown formatting.
|
| 8 |
|
| 9 | ## Install
|
| 10 |
|
| 11 | ```
|
| 12 | $ npm install --global standup-boy
|
| 13 | ```
|
| 14 |
|
| 15 | ```
|
| 16 | $ standup-boy --help
|
| 17 |
|
| 18 | Usage
|
| 19 | standup-boy
|
| 20 |
|
| 21 | Examples
|
| 22 | $ standup-boy
|
| 23 | ? What did I accomplish yesterday? Something!
|
| 24 | ? What will I do today? Something Else!
|
| 25 | ? What obstacles are impeding my progress? Any info I need or want to share? Not much...
|
| 26 |
|
| 27 | :triumph: **`What did I accomplish yesterday`**
|
| 28 | Something!
|
| 29 | :scream_cat: **`What will I do today`**
|
| 30 | Something Else!
|
| 31 | :cry: **`What obstacles are impeding my progress? Any info I need or want to share?`**
|
| 32 | Not much...
|
| 33 | Copied the result to the clipboard!
|
| 34 | ```
|
| 35 |
|
| 36 | ## Configuration
|
| 37 |
|
| 38 | You can obtain the path to the configuration file by simply running `standup-boy --path`. Edit the resulting file to override the defaults.
|
| 39 |
|
| 40 | Mind that this configuration only alters the final text that gets copied into your clipboard.
|
| 41 |
|
| 42 | ### Templates
|
| 43 |
|
| 44 | One can configure `standup-boy` to replace the default templates for the resulting standup text.
|
| 45 |
|
| 46 | An example of an alternative configuration, written in JSON format:
|
| 47 |
|
| 48 | ```json
|
| 49 | {
|
| 50 | "yesterday": "Hey, you! What did you do yesterday?",
|
| 51 |
|
| 52 | "today": "Oh really? And what are you gonna do today?",
|
| 53 |
|
| 54 | "obstacles": "Did you find any obstacles along the way, tho?"
|
| 55 | }
|
| 56 | ```
|
| 57 |
|
| 58 | ### Replace words
|
| 59 |
|
| 60 | `standup-boy` can also be configured to search and replace certain keywords for, for example, automatically link to JIRA tasks. RegExp syntax is supported.
|
| 61 |
|
| 62 | If you want to introduce the matched string into the replaced value, you can add the `%VAL%` keyword anywhere in your resulting text to interpolate the matched variable into it.
|
| 63 |
|
| 64 | An example of an alternative configuration, written in JSON format:
|
| 65 |
|
| 66 | ```json
|
| 67 | {
|
| 68 | "replace" :
|
| 69 | {
|
| 70 | "JIRA-[0-9]*": "[%VAL%](https://your-jira.url/%VAL%)"
|
| 71 | }
|
| 72 | }
|
| 73 | ```
|
| 74 |
|
| 75 | This results in this text:
|
| 76 |
|
| 77 | ```
|
| 78 | I completed JIRA-220 today!
|
| 79 | ```
|
| 80 |
|
| 81 | Being replaced by:
|
| 82 |
|
| 83 | ```
|
| 84 | I completed [JIRA-220](https://your-jira.url/JIRA-220) today!
|
| 85 | ```
|
| 86 |
|
| 87 | If translated to markdown, a nice link appears in place of the old, lame, jira task name.
|
| 88 |
|
| 89 | ## License
|
| 90 |
|
| 91 | MIT © [vikepic](https://vikepic.github.io)
|