| <!-- Generated with Stardoc: http://skydoc.bazel.build --> | |
| Skylib module containing convenience interfaces for select(). | |
| <a id="selects.config_setting_group"></a> | |
| ## selects.config_setting_group | |
| <pre> | |
| load("@bazel_skylib//lib:selects.bzl", "selects") | |
| selects.config_setting_group(<a href="#selects.config_setting_group-name">name</a>, <a href="#selects.config_setting_group-match_any">match_any</a>, <a href="#selects.config_setting_group-match_all">match_all</a>, <a href="#selects.config_setting_group-visibility">visibility</a>) | |
| </pre> | |
| Matches if all or any of its member `config_setting`s match. | |
| Example: | |
| ```build | |
| config_setting(name = "one", define_values = {"foo": "true"}) | |
| config_setting(name = "two", define_values = {"bar": "false"}) | |
| config_setting(name = "three", define_values = {"baz": "more_false"}) | |
| config_setting_group( | |
| name = "one_two_three", | |
| match_all = [":one", ":two", ":three"] | |
| ) | |
| cc_binary( | |
| name = "myapp", | |
| srcs = ["myapp.cc"], | |
| deps = select({ | |
| ":one_two_three": [":special_deps"], | |
| "//conditions:default": [":default_deps"] | |
| }) | |
| ``` | |
| **PARAMETERS** | |
| | Name | Description | Default Value | | |
| | :------------- | :------------- | :------------- | | |
| | <a id="selects.config_setting_group-name"></a>name | The group's name. This is how `select()`s reference it. | none | | |
| | <a id="selects.config_setting_group-match_any"></a>match_any | A list of `config_settings`. This group matches if *any* member in the list matches. If this is set, `match_all` must not be set. | `[]` | | |
| | <a id="selects.config_setting_group-match_all"></a>match_all | A list of `config_settings`. This group matches if *every* member in the list matches. If this is set, `match_any` must be not set. | `[]` | | |
| | <a id="selects.config_setting_group-visibility"></a>visibility | Visibility of the config_setting_group. | `None` | | |
| <a id="selects.with_or"></a> | |
| ## selects.with_or | |
| <pre> | |
| load("@bazel_skylib//lib:selects.bzl", "selects") | |
| selects.with_or(<a href="#selects.with_or-input_dict">input_dict</a>, <a href="#selects.with_or-no_match_error">no_match_error</a>) | |
| </pre> | |
| Drop-in replacement for `select()` that supports ORed keys. | |
| Example: | |
| ```build | |
| deps = selects.with_or({ | |
| "//configs:one": [":dep1"], | |
| ("//configs:two", "//configs:three"): [":dep2or3"], | |
| "//configs:four": [":dep4"], | |
| "//conditions:default": [":default"] | |
| }) | |
| ``` | |
| Key labels may appear at most once anywhere in the input. | |
| **PARAMETERS** | |
| | Name | Description | Default Value | | |
| | :------------- | :------------- | :------------- | | |
| | <a id="selects.with_or-input_dict"></a>input_dict | The same dictionary `select()` takes, except keys may take either the usual form `"//foo:config1"` or `("//foo:config1", "//foo:config2", ...)` to signify `//foo:config1` OR `//foo:config2` OR `...`. | none | | |
| | <a id="selects.with_or-no_match_error"></a>no_match_error | Optional custom error to report if no condition matches. | `""` | | |
| **RETURNS** | |
| A native `select()` that expands | |
| `("//configs:two", "//configs:three"): [":dep2or3"]` | |
| to | |
| ```build | |
| "//configs:two": [":dep2or3"], | |
| "//configs:three": [":dep2or3"], | |
| ``` | |
| <a id="selects.with_or_dict"></a> | |
| ## selects.with_or_dict | |
| <pre> | |
| load("@bazel_skylib//lib:selects.bzl", "selects") | |
| selects.with_or_dict(<a href="#selects.with_or_dict-input_dict">input_dict</a>) | |
| </pre> | |
| Variation of `with_or` that returns the dict of the `select()`. | |
| Unlike `select()`, the contents of the dict can be inspected by Starlark | |
| macros. | |
| **PARAMETERS** | |
| | Name | Description | Default Value | | |
| | :------------- | :------------- | :------------- | | |
| | <a id="selects.with_or_dict-input_dict"></a>input_dict | Same as `with_or`. | none | | |
| **RETURNS** | |
| A dictionary usable by a native `select()`. | |