Unflatmap community.general (#5461)

* Move files.

* Update imports and references.

* Move wrongly placed files.

* Reverse redirects, deprecate long → short name redirects.

* Simplify contribution guidelines for new modules.

* Rewrite BOTMETA.

* Add changelog fragment.

* Fix ignore.txt files.

plugins/modules/mksysb.py

@@ -0,0 +1,161 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2021, Alexei Znamensky (@russoz) <russoz@gmail.com>
+# Copyright (c) 2017, Kairo Araujo <kairo@kairo.eti.br>
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from __future__ import absolute_import, division, print_function
+
+__metaclass__ = type
+
+DOCUMENTATION = '''
+---
+author: Kairo Araujo (@kairoaraujo)
+module: mksysb
+short_description: Generates AIX mksysb rootvg backups.
+description:
+  - This module manages a basic AIX mksysb (image) of rootvg.
+options:
+  backup_crypt_files:
+    description:
+      - Backup encrypted files.
+    type: bool
+    default: true
+  backup_dmapi_fs:
+    description:
+      - Back up DMAPI filesystem files.
+    type: bool
+    default: true
+  create_map_files:
+    description:
+      - Creates a new MAP files.
+    type: bool
+    default: false
+  exclude_files:
+    description:
+      - Excludes files using C(/etc/rootvg.exclude).
+    type: bool
+    default: false
+  exclude_wpar_files:
+    description:
+      - Excludes WPAR files.
+    type: bool
+    default: false
+  extended_attrs:
+    description:
+      - Backup extended attributes.
+    type: bool
+    default: true
+  name:
+    type: str
+    description:
+      - Backup name
+    required: true
+  new_image_data:
+    description:
+      - Creates a new file data.
+    type: bool
+    default: true
+  software_packing:
+    description:
+      - Exclude files from packing option listed in
+        C(/etc/exclude_packing.rootvg).
+    type: bool
+    default: false
+  storage_path:
+    type: str
+    description:
+      - Storage path where the mksysb will stored.
+    required: true
+  use_snapshot:
+    description:
+      - Creates backup using snapshots.
+    type: bool
+    default: false
+'''
+
+EXAMPLES = '''
+- name: Running a backup image mksysb
+  community.general.mksysb:
+    name: myserver
+    storage_path: /repository/images
+    exclude_files: true
+    exclude_wpar_files: true
+'''
+
+RETURN = '''
+changed:
+  description: Return changed for mksysb actions as true or false.
+  returned: always
+  type: bool
+msg:
+  description: Return message regarding the action.
+  returned: always
+  type: str
+'''
+
+import os
+
+from ansible_collections.community.general.plugins.module_utils.module_helper import (
+    CmdModuleHelper, ArgFormat
+)
+
+
+class MkSysB(CmdModuleHelper):
+    module = dict(
+        argument_spec=dict(
+            backup_crypt_files=dict(type='bool', default=True),
+            backup_dmapi_fs=dict(type='bool', default=True),
+            create_map_files=dict(type='bool', default=False),
+            exclude_files=dict(type='bool', default=False),
+            exclude_wpar_files=dict(type='bool', default=False),
+            extended_attrs=dict(type='bool', default=True),
+            name=dict(type='str', required=True),
+            new_image_data=dict(type='bool', default=True),
+            software_packing=dict(type='bool', default=False),
+            storage_path=dict(type='str', required=True),
+            use_snapshot=dict(type='bool', default=False)
+        ),
+        supports_check_mode=True,
+    )
+    command = ['mksysb', '-X']
+    command_args_formats = dict(
+        create_map_files=dict(fmt="-m", style=ArgFormat.BOOLEAN),
+        use_snapshot=dict(fmt="-T", style=ArgFormat.BOOLEAN),
+        exclude_files=dict(fmt="-e", style=ArgFormat.BOOLEAN),
+        exclude_wpar_files=dict(fmt="-G", style=ArgFormat.BOOLEAN),
+        new_image_data=dict(fmt="-i", style=ArgFormat.BOOLEAN),
+        software_packing=dict(fmt="-p", style=ArgFormat.BOOLEAN_NOT),
+        extended_attrs=dict(fmt="-a", style=ArgFormat.BOOLEAN),
+        backup_crypt_files=dict(fmt="-Z", style=ArgFormat.BOOLEAN_NOT),
+        backup_dmapi_fs=dict(fmt="-A", style=ArgFormat.BOOLEAN),
+        combined_path=dict(fmt=lambda p, n: ["%s/%s" % (p, n)], stars=1)
+    )
+
+    def __init_module__(self):
+        if not os.path.isdir(self.vars.storage_path):
+            self.do_raise("Storage path %s is not valid." % self.vars.storage_path)
+
+    def __run__(self):
+        if not self.module.check_mode:
+            self.run_command(params=[
+                'create_map_files', 'use_snapshot', 'exclude_files', 'exclude_wpar_files', 'software_packing',
+                'extended_attrs', 'backup_crypt_files', 'backup_dmapi_fs', 'new_image_data',
+                {'combined_path': [self.vars.storage_path, self.vars.name]},
+            ])
+        self._changed = True
+
+    def process_command_output(self, rc, out, err):
+        if rc != 0:
+            self.do_raise("mksysb failed.")
+        self.vars.msg = out
+
+
+def main():
+    MkSysB.execute()
+
+
+if __name__ == '__main__':
+    main()