You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ansible/test/units
Ganesh Nalawade 97a34cf008 Add options sub spec validation (#27119)
* Add aggregate parameter validation

aggregate parameter validation will support checking each individual dict
to resolve conditions for aliases, no_log, mutually_exclusive,
required, type check, values, required_together, required_one_of
and required_if conditions in argspec. It will also set default values.

eg:
tasks:
  - name: Configure interface attribute with aggregate
    net_interface:
      aggregate:
        - {name: ge-0/0/1, description: test-interface-1, duplex: full, state: present}
        - {name: ge-0/0/2, description: test-interface-2, active: False}
    register: response
    purge: Yes

Usage:
```
from ansible.module_utils.network_common import AggregateCollection

transform = AggregateCollection(module)
param = transform(module.params.get('aggregate'))
```

Aggregate allows supports for `purge` parameter, it will instruct the module
to remove resources from remote device that hasn’t been explicitly
defined in aggregate. This is not supported by with_* iterators

Also, it improves performace as compared to with_* iterator for network device
that has seperate candidate and running datastore.
For with_* iteration the sequence of operartion is
load-config-1 (candidate db) -> commit (running db) -> load_config-2
(candidate db) -> commit (running db) ...

With aggregate the sequence of operation is
load-config-1 (candidate db) -> load-config-2 (candidate db) -> commit
(running db)

As commit is executed only once per task for aggregate it has
huge perfomance benefit for large configurations.

* Fix CI issues

* Fix review comments

*  Add support for options validation for aliases, no_log,
   mutually_exclusive, required, type check, value check,
   required_together, required_one_of and required_if
   conditions in sub-argspec.
*  Add unit test for options in argspec.
*  Reverted aggregate implementaion.

* Minor change

* Add multi-level argspec support

*  Multi-level argspec support with module's top most
   conditionals options.

* Fix unit test failure

* Add parent context in errors for sub options

* Resolve merge conflict

* Fix CI issue
9 years ago
..
cli Support multiple vault passwords (#22756) 9 years ago
contrib Update vmware_inventory (#26308) 9 years ago
errors test/: PEP8 compliancy (#24803) 9 years ago
executor Remove automatic use of system six 9 years ago
inventory INI inventory plugin: add documentation about variable types (#25798) 9 years ago
inventory_test_data/group_vars Merge branch 'v2_final' into devel_switch_v2 11 years ago
mock Support multiple vault passwords (#22756) 9 years ago
module_utils Add options sub spec validation (#27119) 9 years ago
modules ACI module_utils library for ACI modules (#27070) 9 years ago
parsing Support multiple vault passwords (#22756) 9 years ago
playbook Fix undefined variables, basestring usage, and some associated python3 issues 9 years ago
plugins Disable abstract-class-instantiated for smoketests 9 years ago
template test/: PEP8 compliancy (#24803) 9 years ago
utils test/: PEP8 compliancy (#24803) 9 years ago
vars Fix spelling mistakes (comments only) (#25564) 9 years ago
__init__.py Add empty-init code-smell script. (#18406) 9 years ago
conftest.py Fix bugs in ansible-test units command. (#24044) 9 years ago
test_constants.py 1st part of ansible config, adds ansible-config to view/manage configs (#12797) 9 years ago