Skip to content
Snippets Groups Projects
  • Thomas Woerner's avatar
    44e2718a
    ipahost: Fix documentation sections and agument spec · 44e2718a
    Thomas Woerner authored
    ansible-test with ansible-2.14 is adding a lot of new tests to ensure
    that the documentation section and the agument spec is complete. Needed
    changes:
    
    DOCUMENTATION section
    
    - `type: str` needs to be set for string parameters
    - `type: list` needs to be set for list parameters
    - `elements: str` needs to be given for list of string parameters
    - `suboptions` instead of `options` needs to be used for dict parameters
    - `required` tags need to be fixed according to the `argument_spec`
    - `aliases` tag needs to match `argument_spec`
    - `type` tag needs to match `argument_spec`
    - `default` tag needs to match `argument_spec`
    - `author` needs to be given with the github user also: `Name (@user)`
    
    RETURN section
    
    - `contains` needs to be used instead of `options` for dicts
    - `type: str` needs to be used for string parameters
    
    argument_spec
    
    - `elements="str"` needs to be added to all list of string parameters
    - `no_log=False` or `no_log=True` needs to be set for all parameters
      that have `key` in the name or for dicts also in one the key names
    
    The `copyright` date is extended with `-2022`.
    
    Additional changes:
    
    - Parameter sshpubkey changed to list of strings in argument_spec
    - New test test/host/test_host_sshpubkey.yml
    44e2718a
    History
    ipahost: Fix documentation sections and agument spec
    Thomas Woerner authored
    ansible-test with ansible-2.14 is adding a lot of new tests to ensure
    that the documentation section and the agument spec is complete. Needed
    changes:
    
    DOCUMENTATION section
    
    - `type: str` needs to be set for string parameters
    - `type: list` needs to be set for list parameters
    - `elements: str` needs to be given for list of string parameters
    - `suboptions` instead of `options` needs to be used for dict parameters
    - `required` tags need to be fixed according to the `argument_spec`
    - `aliases` tag needs to match `argument_spec`
    - `type` tag needs to match `argument_spec`
    - `default` tag needs to match `argument_spec`
    - `author` needs to be given with the github user also: `Name (@user)`
    
    RETURN section
    
    - `contains` needs to be used instead of `options` for dicts
    - `type: str` needs to be used for string parameters
    
    argument_spec
    
    - `elements="str"` needs to be added to all list of string parameters
    - `no_log=False` or `no_log=True` needs to be set for all parameters
      that have `key` in the name or for dicts also in one the key names
    
    The `copyright` date is extended with `-2022`.
    
    Additional changes:
    
    - Parameter sshpubkey changed to list of strings in argument_spec
    - New test test/host/test_host_sshpubkey.yml