FEATURE: Ansible module for storage partition info

An Ansible module for returning storage partition info for a given scope.

The module takes two optional parameters:
`scope` for specifying the scope of the data to return. Valid choices are: `global` (default), `appliance`, `os`, `environment`, and `host`.
`name` for requesting the data for a specific item in the scope. If name is not provided, then all data for that scope is returned.

The data returned is a list of `partitions`.

Example playbook:
```
---
- hosts: localhost
  tasks:
    - name: Get global partition info
      stacki_storage_partition_info:
      register: result

    - name: Global partition output
      debug:
        var: result

    - name: Get host partition output for backend-0-0
      stacki_storage_partition_info:
        name: backend-0-0
        scope: host
      register: result

    - name: Host backend-0-0 partition output
      debug:
        var: result
```

Output of the debug commands, showing the structure of the data returned:
```
TASK [Global partition output] *********************************************************************************************************************************
ok: [localhost] => {
    "result": {
        "changed": false,
        "failed": false,
        "partitions": [
            {
                "device": "/dev/sda1",
                "fstype": "ext4",
                "mountpoint": "/",
                "options": "",
                "partid": 1,
                "size": "10000"
            }
        ]
    }
}

TASK [Host backend-0-0 partition output] ***********************************************************************************************************************
ok: [localhost] => {
    "result": {
        "changed": false,
        "failed": false,
        "partitions": [
            {
                "device": "/dev/sda1",
                "fstype": "ext4",
                "host": "backend-0-0",
                "mountpoint": "/",
                "options": "",
                "partid": 1,
                "size": "10000",
                "source": "H"
            }
        ]
    }
}
```

Author: caladd

common/src/stack/ansible/plugins/modules/stacki_storage_partition_info.py

@@ -0,0 +1,171 @@
+# @copyright@
+# Copyright (c) 2006 - 2020 Teradata
+# All rights reserved. Stacki(r) v5.x stacki.com
+# https://github.com/Teradata/stacki/blob/master/LICENSE.txt
+# @copyright@
+
+DOCUMENTATION = """
+module: stacki_storage_partition_info
+short_description: Return data about Stacki storage partitions
+description:
+  - If name is supplied, and scope is not global, returns data about a single scoped item
+  - If name is supplied, and scope is global, then an error is returned
+  - If name is not supplied, and scope is not global, then all data in that scope is returned
+  - If name is not supplied, and scope is global, then all global data is returned
+
+options:
+  name:
+    description:
+      - The name of the scoped item to return data about
+    type: str
+    required: false
+
+  scope:
+    description:
+      - The scope to return data about
+    type: str
+    required: false
+    choices: ['global', 'appliance', 'os', 'environment', 'host']
+    default: global
+"""
+
+EXAMPLES = """
+- name: Get all global data
+  stacki_storage_partition_info:
+  register: results
+
+- name: Get data about backend appliance
+  stacki_storage_partition_info:
+    name: backend
+    scope: appliance
+  register: results
+
+- name: Get data about all hosts
+  stacki_storage_partition_info:
+    scope: host
+  register: results
+"""
+
+RETURN = """
+partitions:
+  description:
+    - List of storage partitions
+  returned: on success
+  type: complex
+  contains:
+    appliance:
+      description:
+        - Name of the appliance for this data
+      type: str
+      returned: scope is appliance
+
+    os:
+      description:
+        - Name of the os for this data
+      type: str
+      returned: scope is os
+
+    environment:
+      description:
+        - Name of the environment for this data
+      type: str
+      returned: scope is environment
+
+    host:
+      description:
+        - Name of the host for this data
+      type: str
+      returned: scope is host
+
+    device:
+      description:
+        - Disk device of the partition
+      type: str
+
+    partid:
+      description:
+        - Partition ID or None
+      type: int
+
+    mountpoint:
+      description:
+        - Mount point of the partition
+      type: str
+
+    size:
+      description:
+        - Size of the partition in megabytes as a string, or possibly 'recommended' or 'hibernation' if mountpoint is 'swap'
+      type: str
+
+    fstype:
+      description:
+        - File system type of the partition
+      type: str
+
+    options:
+      description:
+        - Partition options
+      type: str
+
+    source:
+      description:
+        - The scope source of the data
+      type: str
+      choices: ['G', 'A', 'O', 'E', 'H']
+      returned: scope is host
+"""
+
+from ansible.module_utils.basic import AnsibleModule
+from ansible.module_utils.stacki import run_stack_command, StackCommandError
+
+
+def main():
+	# Define the arguments for this module
+	argument_spec = dict(
+		name=dict(type="str", required=False, default=None),
+		scope=dict(
+			type="str", required=False, default="global",
+			choices=["global", "appliance", "os", "environment", "host"]
+		)
+	)
+
+	# Create our module object
+	module = AnsibleModule(
+		argument_spec=argument_spec,
+		supports_check_mode=True
+	)
+
+	# Initialize a blank result
+	result = {
+		"changed": False,
+		"partitions": []
+	}
+
+	# Bail if the user is just checking syntax of their playbook
+	if module.check_mode:
+		module.exit_json(**result)
+
+	# Fetch our info from Stacki
+	args = ["scope=" + module.params["scope"]]
+
+	if module.params["name"]:
+		args.append(module.params["name"])
+
+	try:
+		for partition in run_stack_command("list.storage.partition", args):
+			# Make sure size is a string
+			partition["size"] = str(partition["size"])
+
+			# Add it to the results
+			result["partitions"].append(partition)
+
+	except StackCommandError as e:
+		# Fetching the data failed
+		module.fail_json(msg=e.message, **result)
+
+	# Return our data
+	module.exit_json(**result)
+
+
+if __name__ == "__main__":
+	main()