Issue geerlingguy#202: Add collection test.

Author: geerlingguy

Diff for: .travis.yml

@@ -6,6 +6,9 @@ branches:
     - master
 
 env:
+  - playbook: collection.yml
+    distro: centos7
+
   # Run each test playbook in a separate environment.
   - playbook: deployments.yml
     distro: ubuntu1804

Diff for: README.md

@@ -42,7 +42,7 @@ Here is an outline of all the examples contained in this repository, by chapter:
 ### Chapter 7
 
   - [`test-plugin`](test-plugin/): A simple test plugin that verifies a given value is representative of the color blue.
-  - [`collection`](collection/): TODO.
+  - [`collection`](collection/): An example local collection to demonstrate the basic structure of content collections.
 
 ### Chapter 8
 

Diff for: collection/README.md

@@ -0,0 +1,3 @@
+# Ansible Local Collection Example
+
+TODO.

Diff for: collection/ansible.cfg

@@ -0,0 +1,3 @@
+[defaults]
+collections_paths = ./
+nocows = 1

Diff for: collection/ansible_collections/local/colors/galaxy.yml

@@ -0,0 +1,7 @@
+---
+namespace: local
+name: colors
+version: 1.0.0
+readme: README.md
+authors:
+- your name <[email protected]>

Diff for: collection/ansible_collections/local/colors/plugins/test/blue.py

@@ -0,0 +1,23 @@
+# Ansible custom 'blue' test plugin definition.
+
+def is_blue(string):
+    ''' Return True if a valid CSS value of 'blue'. '''
+    blue_values = [
+        'blue',
+        '#0000ff',
+        '#00f',
+        'rgb(0,0,255)',
+        'rgb(0%,0%,100%)',
+    ]
+    if string in blue_values:
+        return True
+    else:
+        return False
+
+class TestModule(object):
+    ''' Return dict of custom jinja tests. '''
+
+    def tests(self):
+        return {
+            'blue': is_blue
+        }

Diff for: collection/main.yml

@@ -0,0 +1,14 @@
+---
+- hosts: all
+
+  vars:
+    my_color_choice: blue
+
+  tasks:
+    - name: "Verify {{ my_color_choice }} is a form of blue."
+      assert:
+        that: my_color_choice is local.colors.blue
+
+    - name: "Verify yellow is not a form of blue."
+      assert:
+        that: "'yellow' is not local.colors.blue"

Diff for: tests/collection.yml

@@ -0,0 +1,2 @@
+---
+- import_playbook: ../collection/main.yml