Add api_facts module (#88)

* Add API docs fragment.

* Improve documentation.

* Move API code to api module_utils.

* Improve docs.

* Add api_facts module.

Does not yet support 'config'. I'm not sure whether that's actually
possible with the API.

* Convert subnet to integer if possible.

* Cleanup.

* Linting and fix tests.

* Remove things that make no sense.

* Simplify code.

* Add basic tests.

* Lint.

tests/unit/plugins/modules/fake_api.py

@@ -0,0 +1,115 @@
+# 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/>.
+
+# Make coding more python3-ish
+from __future__ import (absolute_import, division, print_function)
+__metaclass__ = type
+
+
+class FakeLibRouterosError(Exception):
+    def __init__(self, message):
+        self.message = message
+        super(FakeLibRouterosError, self).__init__(self.message)
+
+
+class TrapError(FakeLibRouterosError):
+    def __init__(self, message="failure: already have interface with such name"):
+        super(TrapError, self).__init__(message)
+
+
+# fixtures
+class fake_ros_api(object):
+    def __init__(self, api, path):
+        pass
+
+    def path(self, api, path):
+        fake_bridge = [{".id": "*DC", "name": "b2", "mtu": "auto", "actual-mtu": 1500,
+                        "l2mtu": 65535, "arp": "enabled", "arp-timeout": "auto",
+                        "mac-address": "3A:C1:90:D6:E8:44", "protocol-mode": "rstp",
+                        "fast-forward": "true", "igmp-snooping": "false",
+                        "auto-mac": "true", "ageing-time": "5m", "priority":
+                        "0x8000", "max-message-age": "20s", "forward-delay": "15s",
+                        "transmit-hold-count": 6, "vlan-filtering": "false",
+                        "dhcp-snooping": "false", "running": "true", "disabled": "false"}]
+        return fake_bridge
+
+    def arbitrary(self, api, path):
+        def retr(self, *args, **kwargs):
+            if 'name' not in kwargs.keys():
+                raise TrapError(message="no such command")
+            dummy_test_string = '/interface/bridge add name=unit_test_brige_arbitrary'
+            result = "/%s/%s add name=%s" % (path[0], path[1], kwargs['name'])
+            return [result]
+        return retr
+
+    def add(self, name):
+        if name == "unit_test_brige_exist":
+            raise TrapError
+        return '*A1'
+
+    def remove(self, id):
+        if id != "*A1":
+            raise TrapError(message="no such item (4)")
+        return '*A1'
+
+    def update(self, **kwargs):
+        if kwargs['.id'] != "*A1" or 'name' not in kwargs.keys():
+            raise TrapError(message="no such item (4)")
+        return ["updated: {'.id': '%s' % kwargs['.id'], 'name': '%s' % kwargs['name']}"]
+
+    def select(self, *args):
+        dummy_bridge = [{".id": "*A1", "name": "dummy_bridge_A1"},
+                        {".id": "*A2", "name": "dummy_bridge_A2"},
+                        {".id": "*A3", "name": "dummy_bridge_A3"}]
+
+        result = []
+        for dummy in dummy_bridge:
+            found = {}
+            for search in args:
+                if search in dummy.keys():
+                    found[search] = dummy[search]
+                else:
+                    continue
+            if len(found.keys()) == 2:
+                result.append(found)
+
+        if result:
+            return result
+        else:
+            return ["no results for 'interface bridge 'query' %s" % ' '.join(args)]
+
+    def select_where(self, api, path):
+        api_path = Where()
+        return api_path
+
+
+class Where(object):
+    def __init__(self):
+        pass
+
+    def select(self, *args):
+        return self
+
+    def where(self, *args):
+        return ["*A1"]
+
+
+class Key(object):
+    def __init__(self, name):
+        self.name = name
+        self.str_return()
+
+    def str_return(self):
+        return str(self.name)