Merge pull request #615 from caphrim007/feature.add-snmp-support

Adds snmp endpoints

Author: zancas

f5/bigip/tm/sys/__init__.py

@@ -40,6 +40,7 @@
 from f5.bigip.tm.sys.httpd import Httpd
 from f5.bigip.tm.sys.ntp import Ntp
 from f5.bigip.tm.sys.performance import Performances
+from f5.bigip.tm.sys.snmp import Snmp
 from f5.bigip.tm.sys.software import Software
 from f5.bigip.tm.sys.sshd import Sshd
 from f5.bigip.tm.sys.ucs import Ucs
@@ -60,6 +61,7 @@ def __init__(self, tm):
             Ntp,
             Failover,
             Dns,
+            Snmp,
             Sshd,
             Httpd,
             Software,

f5/bigip/tm/sys/snmp.py

@@ -0,0 +1,111 @@
+# coding=utf-8
+#
+#  Copyright 2014-2016 F5 Networks Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+"""BIG-IP® SNMP submodule.
+
+REST URI
+    ``http://localhost/mgmt/tm/sys/snmp/``
+
+GUI Path
+    ``System --> SNMP``
+
+REST Kind
+    ``tm:snmp:*``
+"""
+
+from f5.bigip.resource import Collection
+from f5.bigip.resource import Resource
+from f5.bigip.resource import UnnamedResource
+
+
+class Snmp(UnnamedResource):
+    def __init__(self, sys):
+        super(Snmp, self).__init__(sys)
+        self._meta_data['required_load_parameters'] = set()
+        self._meta_data['required_json_kind'] = 'tm:sys:snmp:snmpstate'
+        self._meta_data['allowed_lazy_attributes'] = [
+            Communities_s,
+            Traps_s,
+            Users_s
+        ]
+        self._meta_data['attribute_registry'] = {
+            'tm:sys:snmp:communities:communitiescollectionstate':
+                Communities_s,
+            'tm:sys:snmp:traps:trapscollectionstate': Traps_s,
+            'tm:sys:snmp:users:userscollectionstate': Users_s
+        }
+
+
+class Communities_s(Collection):
+    """BIG-IP® SNMP Communities collection."""
+    def __init__(self, snmp):
+        super(Communities_s, self).__init__(snmp)
+        self._meta_data['required_json_kind'] = \
+            'tm:sys:snmp:communities:communitiescollectionstate'
+        self._meta_data['allowed_lazy_attributes'] = [Community]
+        self._meta_data['attribute_registry'] = \
+            {'tm:sys:snmp:communities:communitiesstate': Community}
+
+
+class Community(Resource):
+    """BIG-IP® SNMP Community resource."""
+    def __init__(self, communities_s):
+        super(Community, self).__init__(communities_s)
+        self._meta_data['required_json_kind'] = \
+            'tm:sys:snmp:communities:communitiesstate'
+        self._meta_data['required_creation_parameters']\
+            .update(('communityName',))
+
+
+class Traps_s(Collection):
+    """BIG-IP® SNMP Traps collection."""
+    def __init__(self, snmp):
+        super(Traps_s, self).__init__(snmp)
+        self._meta_data['required_json_kind'] = \
+            'tm:sys:snmp:traps:trapscollectionstate'
+        self._meta_data['allowed_lazy_attributes'] = [Trap]
+        self._meta_data['attribute_registry'] = \
+            {'tm:sys:snmp:traps:trapsstate': Trap}
+
+
+class Trap(Resource):
+    """BIG-IP® SNMP Trap resource."""
+    def __init__(self, traps_s):
+        super(Trap, self).__init__(traps_s)
+        self._meta_data['required_json_kind'] = \
+            'tm:sys:snmp:traps:trapsstate'
+
+
+class Users_s(Collection):
+    """BIG-IP® SNMP Users collection."""
+    def __init__(self, snmp):
+        super(Users_s, self).__init__(snmp)
+        self._meta_data['required_json_kind'] = \
+            'tm:sys:snmp:users:userscollectionstate'
+        self._meta_data['allowed_lazy_attributes'] = [User]
+        self._meta_data['attribute_registry'] = \
+            {'tm:sys:snmp:users:usersstate': User}
+
+
+class User(Resource):
+    """BIG-IP® SNMP User resource."""
+    def __init__(self, users_s):
+        super(User, self).__init__(users_s)
+        self._meta_data['required_json_kind'] = \
+            'tm:sys:snmp:users:usersstate'
+        self._meta_data['required_creation_parameters'] \
+            .update(('authProtocol',))

f5/bigip/tm/sys/test/test_snmp.py

@@ -0,0 +1,38 @@
+# Copyright 2016 F5 Networks Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+import mock
+import pytest
+
+from f5.bigip.mixins import UnsupportedMethod
+from f5.bigip.tm.sys.snmp import Snmp
+
+
+@pytest.fixture
+def FakeSnmp():
+    fake_sys = mock.MagicMock()
+    return Snmp(fake_sys)
+
+
+def test_create_raises(FakeSnmp):
+    with pytest.raises(UnsupportedMethod) as EIO:
+        FakeSnmp.create()
+    assert EIO.value.message == "Snmp does not support the create method"
+
+
+def test_delete_raises(FakeSnmp):
+    with pytest.raises(UnsupportedMethod) as EIO:
+        FakeSnmp.delete()
+    assert EIO.value.message == "Snmp does not support the delete method"