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/ip_netns.py

@@ -0,0 +1,133 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+# Copyright (c) 2017, Arie Bregman <abregman@redhat.com>
+# 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 = '''
+---
+module: ip_netns
+author: "Arie Bregman (@bregman-arie)"
+short_description: Manage network namespaces
+requirements: [ ip ]
+description:
+    - Create or delete network namespaces using the ip command.
+options:
+    name:
+        required: false
+        description:
+            - Name of the namespace
+        type: str
+    state:
+        required: false
+        default: "present"
+        choices: [ present, absent ]
+        description:
+            - Whether the namespace should exist
+        type: str
+'''
+
+EXAMPLES = '''
+- name: Create a namespace named mario
+  community.general.ip_netns:
+    name: mario
+    state: present
+
+- name: Delete a namespace named luigi
+  community.general.ip_netns:
+    name: luigi
+    state: absent
+'''
+
+RETURN = '''
+# Default return values
+'''
+
+from ansible.module_utils.basic import AnsibleModule
+from ansible.module_utils.common.text.converters import to_text
+
+
+class Namespace(object):
+    """Interface to network namespaces. """
+
+    def __init__(self, module):
+        self.module = module
+        self.name = module.params['name']
+        self.state = module.params['state']
+
+    def _netns(self, command):
+        '''Run ip nents command'''
+        return self.module.run_command(['ip', 'netns'] + command)
+
+    def exists(self):
+        '''Check if the namespace already exists'''
+        rc, out, err = self.module.run_command(['ip', 'netns', 'list'])
+        if rc != 0:
+            self.module.fail_json(msg=to_text(err))
+        return self.name in out
+
+    def add(self):
+        '''Create network namespace'''
+        rtc, out, err = self._netns(['add', self.name])
+
+        if rtc != 0:
+            self.module.fail_json(msg=err)
+
+    def delete(self):
+        '''Delete network namespace'''
+        rtc, out, err = self._netns(['del', self.name])
+        if rtc != 0:
+            self.module.fail_json(msg=err)
+
+    def check(self):
+        '''Run check mode'''
+        changed = False
+
+        if self.state == 'present' and self.exists():
+            changed = True
+
+        elif self.state == 'absent' and self.exists():
+            changed = True
+        elif self.state == 'present' and not self.exists():
+            changed = True
+
+        self.module.exit_json(changed=changed)
+
+    def run(self):
+        '''Make the necessary changes'''
+        changed = False
+
+        if self.state == 'absent':
+            if self.exists():
+                self.delete()
+                changed = True
+        elif self.state == 'present':
+            if not self.exists():
+                self.add()
+                changed = True
+
+        self.module.exit_json(changed=changed)
+
+
+def main():
+    """Entry point."""
+    module = AnsibleModule(
+        argument_spec={
+            'name': {'default': None},
+            'state': {'default': 'present', 'choices': ['present', 'absent']},
+        },
+        supports_check_mode=True,
+    )
+
+    network_namespace = Namespace(module)
+    if module.check_mode:
+        network_namespace.check()
+    else:
+        network_namespace.run()
+
+
+if __name__ == '__main__':
+    main()