Adding slx_command module and supporting module_utils. (#38235)

* Adding slx_command module and supporting module_utils.

This commit adds the slx_command module and tests as well as the
required slxos module_utils.

* Update copyright in header

* Adding missing module init

* Cleaning up shebangs/licensing.

* Incorporating feedback

Removing reference to `waitfor` alias in `slxos_command` module.
Adding `Extreme Networks` to `short_description` of `slxos_command` module.

* Adding cliconf tests

* Fixing 3.X tests

* Adding docstrings to test methods for slxos cliconf tests

* Adding slxos terminal tests

* Adding slxos module_utils tests

* Adding Extreme Networks team members to BOTMETA.yml

test/units/plugins/cliconf/test_slxos.py

@@ -0,0 +1,140 @@
+#
+# (c) 2018 Extreme Networks Inc.
+#
+# This file is part of Ansible
+#
+# Ansible is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Ansible is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
+#
+from __future__ import (absolute_import, division, print_function)
+__metaclass__ = type
+
+from os import path
+import json
+
+from mock import MagicMock, call
+
+from ansible.compat.tests import unittest
+from ansible.plugins.cliconf import slxos
+
+FIXTURE_DIR = b'%s/fixtures/slxos' % (
+    path.dirname(path.abspath(__file__)).encode('utf-8')
+)
+
+
+def _connection_side_effect(*args, **kwargs):
+    try:
+        if args:
+            value = args[0]
+        else:
+            value = kwargs.get('command')
+
+        fixture_path = path.abspath(
+            b'%s/%s' % (FIXTURE_DIR, b'_'.join(value.split(b' ')))
+        )
+        with open(fixture_path, 'rb') as file_desc:
+            return file_desc.read()
+    except (OSError, IOError):
+        if args:
+            value = args[0]
+            return value
+        elif kwargs.get('command'):
+            value = kwargs.get('command')
+            return value
+
+        return 'Nope'
+
+
+class TestPluginCLIConfSLXOS(unittest.TestCase):
+    """ Test class for SLX-OS CLI Conf Methods
+    """
+    def setUp(self):
+        self._mock_connection = MagicMock()
+        self._mock_connection.send.side_effect = _connection_side_effect
+        self._cliconf = slxos.Cliconf(self._mock_connection)
+
+    def tearDown(self):
+        pass
+
+    def test_get_device_info(self):
+        """ Test get_device_info
+        """
+        device_info = self._cliconf.get_device_info()
+
+        mock_device_info = {
+            'network_os': 'slxos',
+            'network_os_model': 'BR-SLX9140',
+            'network_os_version': '17s.1.02',
+        }
+
+        self.assertEqual(device_info, mock_device_info)
+
+    def test_get_config(self):
+        """ Test get_config
+        """
+        running_config = self._cliconf.get_config()
+
+        fixture_path = path.abspath(b'%s/show_running-config' % FIXTURE_DIR)
+        with open(fixture_path, 'rb') as file_desc:
+            mock_running_config = file_desc.read()
+            self.assertEqual(running_config, mock_running_config)
+
+        startup_config = self._cliconf.get_config()
+
+        fixture_path = path.abspath(b'%s/show_running-config' % FIXTURE_DIR)
+        with open(fixture_path, 'rb') as file_desc:
+            mock_startup_config = file_desc.read()
+            self.assertEqual(startup_config, mock_startup_config)
+
+    def test_edit_config(self):
+        """ Test edit_config
+        """
+        test_config_command = b'this\nis\nthe\nsong\nthat\nnever\nends'
+
+        self._cliconf.edit_config(test_config_command)
+
+        send_calls = []
+
+        for command in [b'configure terminal', test_config_command, b'end']:
+            send_calls.append(call(
+                command=command,
+                prompt_retry_check=False,
+                sendonly=False,
+                newline=True
+            ))
+
+        self._mock_connection.send.assert_has_calls(send_calls)
+
+    def test_get_capabilities(self):
+        """ Test get_capabilities
+        """
+        capabilities = json.loads(self._cliconf.get_capabilities())
+        mock_capabilities = {
+            'network_api': 'cliconf',
+            'rpc': [
+                'get_config',
+                'edit_config',
+                'get_capabilities',
+                'get'
+            ],
+            'device_info': {
+                'network_os_model': 'BR-SLX9140',
+                'network_os_version': '17s.1.02',
+                'network_os': 'slxos'
+            }
+        }
+
+        self.assertEqual(
+            mock_capabilities,
+            capabilities
+        )