# ComponentSelectionRules

API Documentation: | `ComponentSelectionRules`

Represents a container for component selection rules. Rules can be applied as part of the resolutionStrategy of a configuration and individual components can be explicitly accepted or rejected by rule. Components that are neither accepted or rejected will be subject to the default version matching strategies.

    configurations {
        conf {
            resolutionStrategy {
                componentSelection {
                    all { ComponentSelection selection ->
                        if (selection.candidate.module == 'someModule' && selection.candidate.version == '1.1') {
                            selection.reject("bad version '1.1' for 'someModule'")
                        }
                    }
                    all { ComponentSelection selection ->
                        if (selection.candidate.module == 'someModule' && selection.getDescriptor(IvyModuleDescriptor)?.branch == 'testing') {
                            if (selection.metadata == null || selection.metadata.status != 'milestone') {
                                selection.reject("only use milestones for someModule:testing")
                            }
                        }
                    }
                    withModule("org.sample:api") { ComponentSelection selection ->
                        if (selection.candidate.version == "1.1") {
                            selection.reject("known bad version")
                        }
                    }
                }
            }
        }
    }

### Properties

No properties

### Methods

Method | Description
`all(closure)` | Adds a component selection rule that will apply to all resolved components. Each rule will receive a `ComponentSelection` object as an argument. Injection of other arguments has been deprecated in favor of the added methods on `ComponentSelection`, namely `ComponentSelection.getMetadata()` and `ComponentSelection.getDescriptor(java.lang.Class)`.
`all(ruleSource)` | Adds a rule-source backed component selection rule that will apply to all resolved components. The ruleSource provides the rule as exactly one rule method annotated with `Mutate`. This rule method:
`all(selectionAction)` | Adds a simple component selection rule that will apply to all resolved components. Each rule will receive a `ComponentSelection` object as an argument.
`withModule(id, closure)` | Adds a component selection rule that will apply to the specified module. Each rule will receive a `ComponentSelection` object as an argument. Injection of other arguments has been deprecated in favor of the added methods on `ComponentSelection`, namely `ComponentSelection.getMetadata()` and `ComponentSelection.getDescriptor(java.lang.Class)`.
`withModule(id, ruleSource)` | Adds a rule-source backed component selection rule that will apply to the specified module. The ruleSource provides the rule as exactly one rule method annotated with `Mutate`. This rule method:
`withModule(id, selectionAction)` | Adds a component selection rule that will apply to the specified module. Each rule will receive a `ComponentSelection` object as an argument.

### Script blocks

No script blocks

### Method details

#### `ComponentSelectionRules` `all`(``Closure`<?>` closure)

Adds a component selection rule that will apply to all resolved components. Each rule will receive a `ComponentSelection` object as an argument. Injection of other arguments has been deprecated in favor of the added methods on `ComponentSelection`, namely `ComponentSelection.getMetadata()` and `ComponentSelection.getDescriptor(java.lang.Class)`.

#### `ComponentSelectionRules` `all`(`Object` ruleSource)

Adds a rule-source backed component selection rule that will apply to all resolved components. The ruleSource provides the rule as exactly one rule method annotated with `Mutate`. This rule method:

- must return void.
- must have `ComponentSelection` as its parameter.

Injection of other arguments has been deprecated in favor of the added methods on `ComponentSelection`, namely `ComponentSelection.getMetadata()` and `ComponentSelection.getDescriptor(java.lang.Class)`.

#### `ComponentSelectionRules` `all`(``Action`<? super `ComponentSelection`>` selectionAction)

Adds a simple component selection rule that will apply to all resolved components. Each rule will receive a `ComponentSelection` object as an argument.

#### `ComponentSelectionRules` `withModule`(`Object` id, ``Closure`<?>` closure)

Adds a component selection rule that will apply to the specified module. Each rule will receive a `ComponentSelection` object as an argument. Injection of other arguments has been deprecated in favor of the added methods on `ComponentSelection`, namely `ComponentSelection.getMetadata()` and `ComponentSelection.getDescriptor(java.lang.Class)`.

#### `ComponentSelectionRules` `withModule`(`Object` id, `Object` ruleSource)

Adds a rule-source backed component selection rule that will apply to the specified module. The ruleSource provides the rule as exactly one rule method annotated with `Mutate`. This rule method:

- must return void.
- must have `ComponentSelection` as its parameter.

Injection of other arguments has been deprecated in favor of the added methods on `ComponentSelection`, namely `ComponentSelection.getMetadata()` and `ComponentSelection.getDescriptor(java.lang.Class)`.

#### `ComponentSelectionRules` `withModule`(`Object` id, ``Action`<? super `ComponentSelection`>` selectionAction)

Adds a component selection rule that will apply to the specified module. Each rule will receive a `ComponentSelection` object as an argument.