Contributing

We are not currently accepting community contributions. However, we encourage you to open git issues for bugs, comments or feature requests.

Review this content periodically to learn when and how to make contributions in the future. For the latest information on open issues, see: git issues.

Development

z/OS Ansible Module Testing

This section outlines the processes to develop and run test cases for z/OS Ansible modules.

• Prerequisites
• Configuration and Dependencies
• Run Functional and Unit Tests
• Develop Unit Tests with pytest
• Develop Functional Tests with pytest
• Additional Development Tips

Parsing with BetterArgParser

BetterArgParser goes beyond typical option value parsing and serves as an alternative to parsers such as argparse. It has been designed to validate values often used on z/OS to avoid unnecessary failures on the target such as incorrectly providing a data set name or type. For cases that require further validation, BetterArgParser accepts a BetterArg object that allows for further customization.

It is recommended to use BetterArgParser in conjunction with Ansible’s module argument parser.

This section outlines the features of BetterArgParser, explains how to define arguments, provides examples of dependencies and more:

• Features
• Importing BetterArgParser
• Defining Arguments
• Argument Options
• Built-in Argument Types (arg_type types)
• Custom Functions
• Custom Argument Options
• Mutually Exclusive Arguments
• Dependent Arguments
• Dependencies Example