From 848e360450c397f1dcfc4d8d3f614df05806699a Mon Sep 17 00:00:00 2001 From: Xavier Claessens Date: Wed, 17 Mar 2021 13:27:31 -0400 Subject: interpreter: Add varname as positional arg in dep.get_variable() --- docs/markdown/Reference-manual.md | 8 ++++++-- docs/markdown/snippets/dep_get_variable.md | 8 ++++++++ 2 files changed, 14 insertions(+), 2 deletions(-) create mode 100644 docs/markdown/snippets/dep_get_variable.md (limited to 'docs') diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md index a70c94b..d81be47 100644 --- a/docs/markdown/Reference-manual.md +++ b/docs/markdown/Reference-manual.md @@ -2678,7 +2678,7 @@ an external dependency with the following methods: - includes: any include_directories - sources: any compiled or static sources the dependency has - - `get_variable(cmake : str, pkgconfig : str, configtool : str, + - `get_variable(varname, cmake : str, pkgconfig : str, configtool : str, internal: str, default_value : str, pkgconfig_define : [str, str])` *(since 0.51.0)*: a generic variable getter method, which replaces the get_*type*_variable methods. This allows one to get the variable @@ -2686,8 +2686,12 @@ an external dependency with the following methods: was found. If default_value is set and the value cannot be gotten from the object then default_value is returned, if it is not set then an error is raised. - *(since 0.54.0)* added `internal` keyword. + *(since 0.58.0)* added `varname` as first positional argument. It is used as + default value for `cmake`, `pkgconfig`, `configtool` and `internal` keyword + arguments. It is useful in the common case where `pkgconfig` and `internal` + use the same variable name, in which case it's easier to write `dep.get_variable('foo')` + instead of `dep.get_variable(pkgconfig: 'foo', internal: 'foo')`. ### `disabler` object diff --git a/docs/markdown/snippets/dep_get_variable.md b/docs/markdown/snippets/dep_get_variable.md new file mode 100644 index 0000000..54373d9 --- /dev/null +++ b/docs/markdown/snippets/dep_get_variable.md @@ -0,0 +1,8 @@ +## `dep.get_variable(varname)` + +`dep.get_variable()` now has `varname` as first positional argument. +It is used as default value for `cmake`, `pkgconfig`, `configtool` and `internal` +keyword arguments. It is useful in the common case where `pkgconfig` and `internal` +use the same variable name, in which case it's easier to write `dep.get_variable('foo')` +instead of `dep.get_variable(pkgconfig: 'foo', internal: 'foo')`. + -- cgit v1.1