esp32-s2_dfu/test/vendor/ceedling/plugins/command_hooks/README.md

54 lines
1.2 KiB
Markdown
Raw Normal View History

2019-06-10 11:18:27 +02:00
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
```
2019-11-01 11:48:59 +01:00
Each of these tools can support an :executable string and an :arguments list, like so:
2019-06-10 11:18:27 +02:00
```
:tools:
:post_link_execute:
:executable: objcopy.exe
2019-11-01 11:48:59 +01:00
:arguments:
2019-06-10 11:18:27 +02:00
- ${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
2019-11-01 11:48:59 +01:00
:arguments: "${1} was glorious!"
2019-06-10 11:18:27 +02:00
- :executable: echo
2019-11-01 11:48:59 +01:00
:arguments:
2019-06-10 11:18:27 +02:00
- it kinda made me cry a little.
- you?
```
2019-11-01 11:48:59 +01:00
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.
2019-06-10 11:18:27 +02:00
Happy Tweaking!