summaryrefslogtreecommitdiffstats
path: root/tinyusb/test/vendor/ceedling/plugins/command_hooks/README.md
blob: 8ac64afce0031dbf195df44ba6a9e77f90022759 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
ceedling-command-hooks
======================

Plugin for easily calling command line tools at various points in the build process

Define any of these sections in :tools: to provide additional hooks to be called on demand:

```
    :pre_mock_generate
    :post_mock_generate
    :pre_runner_generate
    :post_runner_generate
    :pre_compile_execute
    :post_compile_execute
    :pre_link_execute
    :post_link_execute
    :pre_test_fixture_execute
    :pre_test
    :post_test
    :pre_release
    :post_release
    :pre_build
    :post_build
```

Each of these tools can support an :executable string and an :arguments list, like so:

```
:tools:
  :post_link_execute:
    :executable: objcopy.exe
    :arguments:
      - ${1} #This is replaced with the executable name
      - output.srec
      - --strip-all
```

You may also specify an array of executables to be called in a particular place, like so:

```
:tools:
  :post_test:
    -  :executable: echo
       :arguments: "${1} was glorious!"
    -  :executable: echo
       :arguments:
         - it kinda made me cry a little.
         - you?
```

Please note that it varies which arguments are being parsed down to the
hooks. For now see `command_hooks.rb` to figure out which suits you best.
Happy Tweaking!