summaryrefslogtreecommitdiff
path: root/test/vendor/ceedling/plugins/command_hooks/README.md
blob: 9fcbbba69f22a087a9e9e4d6d9d4f04d824dd444 (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
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_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 :args list, like so:

```
:tools:
  :post_link_execute:
    :executable: objcopy.exe
    :args:
      - ${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
       :args: "${1} was glorious!"
    -  :executable: echo
       :args:
         - it kinda made me cry a little.
         - you?
```

Happy Tweaking!