aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown
diff options
context:
space:
mode:
authorPaolo Bonzini <pbonzini@redhat.com>2020-09-04 04:50:15 -0400
committerDaniel Mensinger <daniel@mensinger-ka.de>2020-09-04 14:45:20 +0200
commitfa5c2363eb1dd94058aac1a4045d2ab546eed7b9 (patch)
treeeb28e49113496ac423b5cee05e8c603d6e111e49 /docs/markdown
parent0b0873c7438471732e5237b1c667e5a3b3fe3c82 (diff)
downloadmeson-fa5c2363eb1dd94058aac1a4045d2ab546eed7b9.zip
meson-fa5c2363eb1dd94058aac1a4045d2ab546eed7b9.tar.gz
meson-fa5c2363eb1dd94058aac1a4045d2ab546eed7b9.tar.bz2
introspect: add test dependencies info to test/benchmark JSON
Add the ids of any target that needs to be rebuilt before running the tests as computed by the backend, to the introspection data for tests and benchmarks. This also includes anything that appears on the test's command line. Without this information, IDEs must update the entire build before running any test. They can now instead selectively build the test executable itself and anything that is needed to run it. Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Diffstat (limited to 'docs/markdown')
-rw-r--r--docs/markdown/IDE-integration.md6
-rw-r--r--docs/markdown/snippets/introspect_test_deps.md5
2 files changed, 11 insertions, 0 deletions
diff --git a/docs/markdown/IDE-integration.md b/docs/markdown/IDE-integration.md
index 816225f..5188359 100644
--- a/docs/markdown/IDE-integration.md
+++ b/docs/markdown/IDE-integration.md
@@ -247,6 +247,7 @@ line arguments, environment variable settings and how to process the output.
"is_parallel": true / false,
"protocol": "exitcode" / "tap",
"cmd": ["command", "to", "run"],
+ "depends": ["target1-id", "target2-id"],
"env": {
"VARIABLE1": "value 1",
"VARIABLE2": "value 2"
@@ -254,6 +255,11 @@ line arguments, environment variable settings and how to process the output.
}
```
+The `depends` entry *(since 0.56.0)* contains target ids; they can be
+looked up in the targets introspection data. The executable
+pointed to by `cmd` is also included in the entry, as are any
+arguments to the test that are build products.
+
## Build system files
It is also possible to get Meson build files used in your current project. This
diff --git a/docs/markdown/snippets/introspect_test_deps.md b/docs/markdown/snippets/introspect_test_deps.md
new file mode 100644
index 0000000..a29ea09
--- /dev/null
+++ b/docs/markdown/snippets/introspect_test_deps.md
@@ -0,0 +1,5 @@
+## Dependencies listed in test and benchmark introspection
+
+The introspection data for tests and benchmarks now includes the target
+ids for executables and built files that are needed by the test. IDEs can
+use this feature to update the build more quickly before running a test.