/ld-ansible-modules

Primary LanguagePython

Build Status Coverage Status codecov.io

Ansible Version

Join the chat at https://gitter.im/linuxdynasty/ld-ansible-modules

  • These modules are tested against the latest Ansible, unless otherwise specified.

Guidelines

Any modules that I write and submit to https://github.com/ansible/ansible-modules-extras will also be in this repository.

Pull Requests

All modules must include a test with them in order to be accepted.

The tests should include the following..

  • Integration suite using the Ansible v2 API. The integration suite should cover every possible scenario in which the module you are submitting can be used in.
  • Unit tests. Every Method, and function needs to be covered.

Module Writing Guidelines

Beyond what is already written here Developing Modules

  • Do not write everything in main().
  • Do not include module as a parameter to every function.
  • Write complete documentation for each Function/Method/Class. Read this document for examples.. Google python style guide