| OLD | NEW |
| 1 # Devtools | 1 # Devtools |
| 2 | 2 |
| 3 Unopinionated tools for **running**, **debugging** and **testing** Mojo apps. | 3 Unopinionated tools for **running**, **debugging** and **testing** Mojo apps. |
| 4 | 4 |
| 5 The repo consists of: |
| 6 |
| 7 - **devtoolslib** - Python module containing the core scripting functionality |
| 8 for running Mojo apps: shell abstraction with implementations for Android and |
| 9 Linux and support for apptest frameworks |
| 10 - executable scripts - example embedders of devtoolslib and other utils |
| 11 |
| 12 ## Embedding devtoolslib |
| 13 |
| 14 As devtools carry no assumptions about build system or file layout being used, |
| 15 the primary way of using devtools now is to embed the functionality provided by |
| 16 **devtoolslib** in a thin wrapper script. For examples, one can refer to mojo's |
| 17 [shell |
| 18 runner](https://github.com/domokit/mojo/blob/master/mojo/tools/mojo_shell.py) |
| 19 and [apptest |
| 20 runner](https://github.com/domokit/mojo/blob/master/mojo/tools/apptest_runner.py
). |
| 21 |
| 22 ## Executable scripts |
| 23 |
| 24 The set of executable scripts is WIP. We currently offer: |
| 25 |
| 26 - **debugger** - allowing to send commands to the mojo:debugger app running in |
| 27 the shell, allowing e.g. to interactively start and stop tracing |
| 28 |
| 5 ## Install | 29 ## Install |
| 6 | 30 |
| 7 ``` | 31 ``` |
| 8 git clone https://github.com/domokit/devtools.git | 32 git clone https://github.com/domokit/devtools.git |
| 9 ``` | 33 ``` |
| 34 |
| 35 ## File location |
| 36 |
| 37 The library is canonically developed [in the mojo |
| 38 repository](https://github.com/domokit/mojo/tree/master/mojo/devtools/common), |
| 39 https://github.com/domokit/devtools is a mirror allowing to consume it |
| 40 separately. |
| OLD | NEW |