New Ansible Module Boilerplate

sample_module.py

#!/usr/bin/python

# libraries you import here, must be present on the target node.
import os

# You can defined other functions up here to make your code more modular. 
# These functions will need to be called from main(), either directly or through N number of other functions
# that eventually lead back to main()

def main():

    module = AnsibleModule(
        argument_spec = dict(
           paramA = dict(required=True, choices=['onechoice', 'secondchoice']),
           paramB = dict(required=True),
           paramC = dict(required=True)
        ),
        supports_check_mode = False,
    )

# Normalize params to make code cleaner
    paramA = module.params['paramA']
    paramB = module.params['paramB']
    paramC = module.params['paramC']

# Do logic here, can be calls to other functions above main()

    # if it is time to exit, successfully
    module.exit_json(changed=True, somekey='somevalue', otherkey=some_var_value)
    
    # if it is time to exit, with an error
    module.fail_json(msg="Some error message")
    
# import module snippets (must stay here after your code)
from ansible.module_utils.basic import *
if __name__ == '__main__':
  main()