|
|
|
name: external_program
|
|
|
|
long_name: External program
|
|
|
|
description: Opaque object representing an external program
|
|
|
|
|
|
|
|
methods:
|
|
|
|
- name: found
|
|
|
|
returns: bool
|
|
|
|
description: Returns whether the executable was found.
|
|
|
|
|
|
|
|
- name: path
|
|
|
|
returns: str
|
|
|
|
deprecated: 0.55.0
|
|
|
|
description: |
|
|
|
|
*Deprecated:* Use [[external_program.full_path]] instead.
|
|
|
|
|
|
|
|
Returns a string pointing to the script or executable.
|
|
|
|
|
|
|
|
**NOTE:** You should not usually need to use this method. Passing the
|
|
|
|
object itself should work in most contexts where a program can appear,
|
|
|
|
and allows Meson to setup inter-target dependencies correctly (for
|
|
|
|
example in cases where a program might be overridden by a [[build_tgt]]).
|
|
|
|
Only use this if you specifically need a string, such as when embedding
|
|
|
|
a program path into a header file.
|
|
|
|
|
|
|
|
For example:
|
|
|
|
|
|
|
|
```meson
|
|
|
|
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
|
|
|
|
description: |
|
|
|
|
Returns a string pointing to the script or executable.
|
|
|
|
|
|
|
|
**NOTE:** You should not usually need to use this method. Passing the
|
|
|
|
object itself should work in most contexts where a program can appear,
|
|
|
|
and allows Meson to setup inter-target dependencies correctly (for
|
|
|
|
example in cases where a program might be overridden by a [[build_tgt]]).
|
|
|
|
Only use this if you specifically need a string, such as when embedding
|
|
|
|
a program path into a header file.
|
|
|
|
|
|
|
|
For example:
|
|
|
|
|
|
|
|
```meson
|
|
|
|
run_command(find_program('foo'), 'arg1', 'arg2')
|
|
|
|
```
|