add tests in goss.py and examples

examples/ansible.cfg

@@ -0,0 +1,2 @@
+[defaults]
+library=./..

examples/playbook.yml

@@ -0,0 +1,48 @@
+---
+
+# success
+- hosts: all
+  connection: local
+  tasks:
+    - name: execute goss test file.
+      goss:
+        path: "~/goss/goss.yaml"
+    - name: Execute goss test file and write result on output_file
+      goss:
+        path: "~/goss/goss.yaml"
+        output_file: "~/goss/result.yaml"
+    - name: Execute test file with json output
+      goss:
+        path: "~/goss/goss.yaml"
+        format: "json"
+# errors
+- hosts: all
+  connection: local
+  tasks:
+    - name: Error because path is a directory
+      goss:
+        path: "~/goss/"
+      ignore_errors: True
+    - name: Error because path does not exists
+      goss:
+        path: "~/goss/toto.yaml"
+      ignore_errors: True
+    - name: Error because output_file is a directory
+      goss:
+        path: "~/goss/goss.yaml"
+        output_file: "~/goss/"
+      ignore_errors: True
+    - name: Error because goss_root not readable
+      goss:
+        path: "~/goss/goss_root.yaml"
+      ignore_errors: True
+    - name: Error because output_file not writable
+      goss:
+        path: "~/goss/goss.yaml"
+        output_file: "/root/result"
+      ignore_errors: True
+    - name: Error because output_file directory not exists
+      goss:
+        path: "~/goss/goss.yaml"
+        output_file: "~/goss/notexists/result"
+      ignore_errors: True

goss.py

@@ -19,7 +19,7 @@
         description:
             - change the output goss format.
             - Goss format list : goss v --format => [documentation json junit nagios rspecish tap].
-            - Default: None
+            - Default: rspecish
     output_file:
         required: false
         description:
@@ -38,12 +38,12 @@
 '''
 
 # launch goss validate command on the file
-def check(module, file_path, output_format):
+def check(module, test_file_path, output_format):
     cmd = ""
     if output_format != None:
-        cmd = "goss -g {0} v --format {1}".format(file_path, output_format)
+        cmd = "goss -g {0} v --format {1}".format(test_file_path, output_format)
     else:
-        cmd = "goss -g {0} v".format(file_path)
+        cmd = "goss -g {0} v".format(test_file_path)
     return module.run_command(cmd)
 
 #write goss result to output_file_path
@@ -62,13 +62,43 @@ def main():
         supports_check_mode=False
     )
 
-    file_path = os.path.expanduser(module.params['path'])
-    output_format = module.params['format']
-    output_file_path = os.path.expanduser(module.params['output_file'])
+    test_file_path = module.params['path'] # test file path
+    output_format = module.params['format'] # goss output format
+    output_file_path = module.params['output_file']
 
-    (rc, out, err) = check(module, file_path, output_format)
+    if test_file_path == None:
+        module.fail_json(msg="test file path is null")
 
-    output_file(output_file_path, out)
+    test_file_path = os.path.expanduser(test_file_path)
+
+    # test if access to test file is ok
+
+    if not os.access(test_file_path, os.R_OK):
+        module.fail_json(msg="Test file %s not readable" % (test_file_path))
+
+    # test if test file is not a dir
+    if os.path.isdir(test_file_path):
+        module.fail_json(msg="Test file must be a file ! : %s" % (test_file_path))
+
+    (rc, out, err) = check(module, test_file_path, output_format)
+
+    if output_file_path != None:
+        output_file_path = os.path.expanduser(output_file_path)
+        # check if output_file is a file
+        if output_file_path.endswith(os.sep):
+            module.fail_json(msg="output_file must be a file. Actually :  %s " % (output_file_path))
+
+        output_dirname = os.path.dirname(output_file_path)
+
+        # check if output directory exists
+        if not os.path.exists(output_dirname):
+            module.fail_json(msg="directory %s does not exists" % (output_dirname))
+
+        # check if writable
+        if not os.access(os.path.dirname(output_file_path), os.W_OK):
+            module.fail_json(msg="Destination %s not writable" % (os.path.dirname(output_file_path)))
+        # write goss result on the output file
+        output_file(output_file_path, out)
 
     if rc is not None and rc != 0:
         error_msg = "err : {0} ; out : {1}".format(err, out)