|
| 1 | +# Using TCR with Scala and sbt |
| 2 | + |
| 3 | +## Prerequisites |
| 4 | + |
| 5 | +- macOS, Linux or Windows |
| 6 | +- [git](https://git-scm.com/) client |
| 7 | +- [curl](https://curl.se/download.html) command line utility |
| 8 | +- [java SDK](https://www.oracle.com/java/technologies/downloads/) with `JAVA_HOME` environment variable properly set up |
| 9 | +- [scala](https://www.scala-lang.org/download/) |
| 10 | +- [sbt](https://www.scala-sbt.org/download/) |
| 11 | + |
| 12 | +## Instructions |
| 13 | + |
| 14 | +### 1 - Open a terminal |
| 15 | + |
| 16 | +> ***Note to Windows users*** |
| 17 | +> |
| 18 | +> Use a **git bash** terminal for running the commands below. |
| 19 | +> _Windows CMD and PowerShell are not supported_ |
| 20 | +
|
| 21 | +### 2 - Launch TCR |
| 22 | + |
| 23 | +> ***Reminder***: the command below should be run from |
| 24 | +> [examples/scala-sbt](.) |
| 25 | +> directory |
| 26 | +
|
| 27 | +From the built-in terminal: |
| 28 | + |
| 29 | +```shell |
| 30 | +./tcrw |
| 31 | +``` |
| 32 | + |
| 33 | +### Cheat Sheet |
| 34 | + |
| 35 | +Here are the main shortcuts available once TCR utility is running: |
| 36 | + |
| 37 | +| Shortcut | Description | |
| 38 | +|-----------|----------------------------------------------| |
| 39 | +| `o` / `O` | Open in browser (with `web` subcommand only) | |
| 40 | +| `d` / `D` | Enter driver role | |
| 41 | +| `n` / `N` | Enter navigator role | |
| 42 | +| `t` / `T` | Query timer status | |
| 43 | +| `p` / `P` | Toggle on/off git auto-push | |
| 44 | +| `l` / `L` | Pull from remote | |
| 45 | +| `s` / `S` | Push to remote | |
| 46 | +| `a` / `A` | Abort current command (when in driver role) | |
| 47 | +| `q` / `Q` | Quit current role / Quit TCR | |
| 48 | +| `?` | List available options | |
| 49 | + |
| 50 | +### Additional Details |
| 51 | + |
| 52 | +Refer to [tcr.md](../../doc/tcr.md) page for additional details and explanations about TCR |
| 53 | +available subcommands and options |
0 commit comments