make the packages role more generic

meta/argument_spec.yml

@@ -0,0 +1,43 @@
+---
+argument_specs:
+  main:
+    short_description: install software easily
+    description:
+      - Make the installation of packages consistent on each platform.
+      - Installs for RedHat, Debian or Darwin based systems.
+    author:
+      - Matthew Stobbs <matthew@stobbs.ca>
+    options:
+      packages:
+        type: "list"
+        elements: "str"
+        required: true
+        description: |
+            The list of packages to install by name.
+      syspkglist:
+        type: "list"
+        elements: "str"
+        required: false
+        description: |
+            Additional packages to install via the system
+            default package manager. Is combined with the
+            completed list of packages to install.
+            Only use this if you a package isn't available to the role.
+      install_state:
+        type: "str"
+        choices:
+          - "present"
+          - "latest"
+          - "absent"
+        required: false
+        default: present
+        description: |
+            Desired state of the packages to install.
+      full_upgrade:
+        type: "bool"
+        required: false
+        default: false
+        description: |
+            Do a full system upgrade before installing
+            additional packages. This does not handle
+            rebooting a machine that has been upgraded.