From 68d4f5bb1d2dc953c1bccad96d7c6707159e0790 Mon Sep 17 00:00:00 2001 From: Klaus Aehlig Date: Mon, 5 Aug 2024 11:16:16 +0200 Subject: Expression language: add expression from_subdir ... allowing to select only the keys in a specific subdir, and move the them to top-level. --- doc/concepts/expressions.md | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'doc') diff --git a/doc/concepts/expressions.md b/doc/concepts/expressions.md index aaea3d27..c75f00dc 100644 --- a/doc/concepts/expressions.md +++ b/doc/concepts/expressions.md @@ -353,6 +353,17 @@ those) argument(s) to obtain the final result. is an error if the values for keys in conflicting positions are name-containing. + - `"from_subdir"` The argument has to be a map (not necessarily of + artifacts). The keys of this map, as well as the value of keyword + argument `"subdir"` (string, default `"."`) are interpreted as + paths; only those key-value pairs of the argument map are kept + where the key refers to an entry in the specified `"subdir"`, + and for those the path relative to the subdir is taken as new + key. Those paths relative to the subdir are taken in canonical + form; it is an error if non-trivial conflicts arise that way, + i.e., if two keys that are kept normalize to the same relative + path while the repsective values are different. + ##### Binary functions - `"=="` The result is `true` is the arguments are equal, -- cgit v1.2.3