Merge pull request #1 from CraigJPerry/test-cases-as-documentation

Author: mivok

.travis.yml

@@ -0,0 +1,9 @@
+language: python
+python:
+  - "2.7"
+install:
+  - "pip install ansible"
+script:
+  - cd tests
+  - ansible-playbook --connection=local --limit=localhost --inventory-file=hosts all.yml
+

README.md

@@ -1,3 +1,5 @@
+[![Build Status](https://travis-ci.org/CraigJPerry/ansible-users.png)](https://travis-ci.org/CraigJPerry/ansible-users)
+
 # Users role
 
 Role to manage users on a system.

tests/add_user.yml

@@ -0,0 +1,52 @@
+---
+
+# It should add a user when given valid metadata
+
+- hosts: test_runners
+  sudo: yes
+
+# Test fixture data
+  vars:
+    users:
+      - username: ansibletestuser
+        name: Ansible Users Role Test Fixture Account
+        groups:
+          - 'users'
+          - 'bin'
+        uid: 2222
+        ssh_key:
+          - "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDVpUJQCOaPg3p5xro9e+1fkGRWNOGrrExiKMqTE91Fwu349bxfMnMzRS0PAERouR9EEL+Ee4Yzhav/uNc35eCtXzACtluXnAncMrQj6pM3IqASynhvXTygHljmcMbBSDQtLrTZeW+YzIcOgk5UM1yBi26WoUYva2aCr9IRvKdYreAK08OiMdZedpOye0ZdvIYJGcyITwc6YMmrAhP7jZlrk/mDEkf2a4eBp+475o7MJtaC9npqYkToM8vqvx5AGEKqXt7/f1/paOY7KsR+VGPQy6k2RkXjWBsXPesZ3d3XLZHE60wAk0EsuJO8A25+uWSB6ILQeRSYYmGea/WIf6kd [email protected]"
+
+# Test setup
+  pre_tasks:
+    - include: cleanup.yml
+    - name: Add Users Test | Pre-Assertions | Ensure ansibletestuser not already present
+      command: "grep ansibletestuser /etc/passwd /etc/group"
+      register: ensure_user_not_present
+      failed_when: ensure_user_not_present.rc == 0
+    - name: Add Users Test | Pre-Assertions | Ensure ansibletestuser home dir not already present
+      command: "ls -d /home/ansibletestuser"
+      register: ensure_home_not_present
+      failed_when: ensure_home_not_present.rc == 0
+
+# Test run
+  roles:
+    - { role: users }
+
+# Test verify successful
+  tasks:
+    - name: Add Users Test | Post-Assertions | Ensure ansibletestuser was created
+      command: "grep ansibletestuser /etc/passwd"
+    - name: Add Users Test | Post-Assertions | Ensure ansibletestuser home dir was created
+      command: "ls -d /home/ansibletestuser"
+    - name: Add Users Test | Post-Assertions | Ensure ssh key was added
+      command: "sudo grep '{{ users[0].ssh_key[0] }}' /home/ansibletestuser/.ssh/authorized_keys"
+    - name: Add Users Test | Post-Assertions | Ensure group was added
+      command: "grep 2222 /etc/group"
+    - name: Add Users Test |  Post-Assertions | Ensure user was added to requested groups
+      command: "grep '^bin.*ansibletestuser' /etc/group"
+
+# Test tear-down
+  post_tasks:
+    - include: cleanup.yml
+

tests/all.yml

@@ -0,0 +1,7 @@
+---
+
+# All users role tests
+
+- include: add_user.yml
+- include: ssh_keys_optional.yml
+

tests/cleanup.yml

@@ -0,0 +1,8 @@
+---
+
+- name: Cleanup | Remove ansibletestuser
+  user: state="absent" name="ansibletestuser"
+
+- name: Cleanup | Remove ansibletestuser home dir
+  file: state="absent" path="/home/ansibletestuser"
+

tests/hosts

@@ -0,0 +1,3 @@
+[test_runners]
+localhost
+

tests/roles/users

@@ -0,0 +1 @@
+../../

tests/ssh_keys_optional.yml

@@ -0,0 +1,45 @@
+---
+
+# SSH keys should not be required
+
+- hosts: test_runners
+  sudo: yes
+
+# Test fixture data
+  vars:
+    users:
+      - username: ansibletestuser
+        name: Ansible Users Role Test Fixture Account
+        uid: 2222
+        groups: []
+        ssh_key: []
+
+# Test setup
+  pre_tasks:
+    - include: cleanup.yml
+    - name: SSH Keys Optional Test | Pre-Assertions | Ensure ansibletestuser not already present
+      command: "grep ansibletestuser /etc/passwd /etc/group"
+      register: ensure_user_not_present
+      failed_when: ensure_user_not_present.rc == 0
+    - name: SSH Keys Optional Test | Pre-Assertions | Ensure ansibletestuser home dir not already present
+      command: "ls -d /home/ansibletestuser"
+      register: ensure_home_not_present
+      failed_when: ensure_home_not_present.rc == 0
+
+# Test run
+  roles:
+    - { role: users }
+
+# Test verify successful
+  tasks:
+    - name: SSH Keys Optional Test | Post-Assertions | Ensure ansibletestuser was created
+      command: "grep ansibletestuser /etc/passwd"
+    - name: SSH Keys Optional Test | Post-Assertions | Ensure no ssh key was added
+      command: "sudo ls /home/ansibletestuser/.ssh/authorized_keys"
+      register: ensure_ssh_key_not_present
+      failed_when: ensure_ssh_key_not_present.rc == 0
+
+# Test tear-down
+  post_tasks:
+    - include: cleanup.yml
+