mirror of
https://github.com/thegeeklab/ansible-later.git
synced 2024-11-16 10:00:39 +00:00
69 lines
1.8 KiB
Python
69 lines
1.8 KiB
Python
|
#!/usr/bin/python
|
||
|
# -*- coding: utf-8 -*-
|
||
|
|
||
|
# Copyright: (c) 2018, Ansible Project
|
||
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
||
|
|
||
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
||
|
'status': ['preview'],
|
||
|
'supported_by': 'community'}
|
||
|
|
||
|
|
||
|
DOCUMENTATION = r'''
|
||
|
---
|
||
|
module: win_pester
|
||
|
short_description: Run Pester tests on Windows hosts
|
||
|
version_added: "2.6"
|
||
|
description:
|
||
|
- Run Pester tests on Windows hosts.
|
||
|
- Test files have to be available on the remote host.
|
||
|
requirements:
|
||
|
- Pester
|
||
|
options:
|
||
|
path:
|
||
|
description:
|
||
|
- Path to a pester test file or a folder where tests can be found.
|
||
|
- If the path is a folder, the module will consider all ps1 files as Pester tests.
|
||
|
required: true
|
||
|
version:
|
||
|
description:
|
||
|
- Minimum version of the pester module that has to be available on the remote host.
|
||
|
author:
|
||
|
- Erwan Quelin (@erwanquelin)
|
||
|
'''
|
||
|
|
||
|
RETURN = r'''
|
||
|
pester_version:
|
||
|
description: Version of the pester module found on the remote host.
|
||
|
returned: always
|
||
|
type: string
|
||
|
sample: 4.3.1
|
||
|
output:
|
||
|
description: Results of the Pester tests.
|
||
|
returned: success
|
||
|
type: list
|
||
|
sample: False
|
||
|
'''
|
||
|
|
||
|
EXAMPLES = r'''
|
||
|
- name: Get facts
|
||
|
setup:
|
||
|
|
||
|
- name: Add Pester module
|
||
|
action:
|
||
|
module_name: "{{ 'win_psmodule' if ansible_powershell_version >= 5 else 'win_chocolatey' }}"
|
||
|
name: Pester
|
||
|
state: present
|
||
|
|
||
|
- name: Run the pester test provided in the path parameter.
|
||
|
win_pester:
|
||
|
path: C:\Pester
|
||
|
|
||
|
# Run pesters tests files that are present in the specified folder
|
||
|
# ensure that the pester module version available is greater or equal to the version parameter.
|
||
|
- name: Run the pester test present in a folder and check the Pester module version.
|
||
|
win_pester:
|
||
|
path: C:\Pester\test01.test.ps1
|
||
|
version: 4.1.0
|
||
|
'''
|