From 0f2f87a003477bd79487a47d5f60f67751e2f44e Mon Sep 17 00:00:00 2001 From: Eli Schwartz Date: Sun, 6 Mar 2022 18:57:40 -0500 Subject: find_program: add a version() method to match the one for dependencies It is often useful to check the found version of a program without checking whether you can successfully find `find_program('foo', required: false, version: '>=XXX')` --- docs/markdown/snippets/find_program-version.md | 5 +++++ docs/yaml/objects/external_program.yaml | 8 ++++++++ 2 files changed, 13 insertions(+) create mode 100644 docs/markdown/snippets/find_program-version.md (limited to 'docs') diff --git a/docs/markdown/snippets/find_program-version.md b/docs/markdown/snippets/find_program-version.md new file mode 100644 index 0000000..fe3a9a6 --- /dev/null +++ b/docs/markdown/snippets/find_program-version.md @@ -0,0 +1,5 @@ +## found programs now have a version method + +The return value of [[find_program]] can now check the exact version of the +found program, independent of the minimum version requirement. This can be used +e.g. to perform different actions depending on the exact version detected. diff --git a/docs/yaml/objects/external_program.yaml b/docs/yaml/objects/external_program.yaml index 02bf48f..f406477 100644 --- a/docs/yaml/objects/external_program.yaml +++ b/docs/yaml/objects/external_program.yaml @@ -24,6 +24,14 @@ methods: run_command(find_program('foo'), 'arg1', 'arg2') ``` +- name: version + returns: str + since: 0.62.0 + description: | + The version number as a string, for example `1.2.8`. + + `unknown` if the program cannot determine the version via a `--version` argument. + - name: full_path returns: str since: 0.55.0 -- cgit v1.1