aboutsummaryrefslogtreecommitdiffstats
path: root/resources/libraries/python/honeycomb/BGP.py
diff options
context:
space:
mode:
Diffstat (limited to 'resources/libraries/python/honeycomb/BGP.py')
-rw-r--r--resources/libraries/python/honeycomb/BGP.py301
1 files changed, 301 insertions, 0 deletions
diff --git a/resources/libraries/python/honeycomb/BGP.py b/resources/libraries/python/honeycomb/BGP.py
new file mode 100644
index 0000000000..ca50cc3120
--- /dev/null
+++ b/resources/libraries/python/honeycomb/BGP.py
@@ -0,0 +1,301 @@
+# Copyright (c) 2017 Cisco and/or its affiliates.
+# 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.
+
+"""Keywords to manipulate BGP configuration using Honeycomb REST API."""
+
+from resources.libraries.python.HTTPRequest import HTTPCodes
+from resources.libraries.python.honeycomb.HoneycombSetup import HoneycombError
+from resources.libraries.python.honeycomb.HoneycombUtil \
+ import HoneycombUtil as HcUtil
+
+
+class BGPKeywords(object):
+ """Keywords to manipulate BGP configuration.
+
+ Implements keywords which read configuration and operational data for
+ the BGP feature, and configure BGP parameters using Honeycomb REST API.
+ """
+
+ def __init__(self):
+ pass
+
+ @staticmethod
+ def _configure_bgp_peer(node, path, data=None):
+ """Send BGP peer configuration data and check the response.
+
+ :param node: Honeycomb node.
+ :param path: Additional path to append to the base BGP config path.
+ :param data: Configuration data to be sent in PUT request.
+ :type node: dict
+ :type path: str
+ :type data: dict
+ :returns: Content of response.
+ :rtype: bytearray
+ :raises HoneycombError: If the status code in response on PUT is not
+ 200 = OK or 201 = ACCEPTED.
+ """
+
+ if data is None:
+ status_code, resp = HcUtil. \
+ delete_honeycomb_data(node, "config_bgp_peer", path)
+ else:
+ status_code, resp = HcUtil.\
+ put_honeycomb_data(node, "config_bgp_peer", data, path)
+ if status_code not in (HTTPCodes.OK, HTTPCodes.ACCEPTED):
+ raise HoneycombError(
+ "The configuration of BGP peer was not successful. "
+ "Status code: {0}.".format(status_code))
+ return resp
+
+ @staticmethod
+ def _configure_bgp_route(node, path, data=None):
+ """Send BGP route configuration data and check the response.
+
+ :param node: Honeycomb node.
+ :param path: Additional path to append to the base BGP config path.
+ :param data: Configuration data to be sent in PUT request.
+ :type node: dict
+ :type path: str
+ :type data: dict
+ :returns: Content of response.
+ :rtype: bytearray
+ :raises HoneycombError: If the status code in response on PUT is not
+ 200 = OK or 201 = ACCEPTED.
+ """
+
+ if data is None:
+ status_code, resp = HcUtil. \
+ delete_honeycomb_data(node, "config_bgp_route", path)
+ else:
+ status_code, resp = HcUtil. \
+ put_honeycomb_data(node, "config_bgp_route", data, path)
+ if status_code not in (HTTPCodes.OK, HTTPCodes.ACCEPTED):
+ raise HoneycombError(
+ "The configuration of BGP route was not successful. "
+ "Status code: {0}.".format(status_code))
+ return resp
+
+ @staticmethod
+ def get_full_bgp_configuration(node):
+ """Get BGP configuration from the node.
+
+ :param node: Honeycomb node.
+ :type node: dict
+ :returns: BGP configuration data.
+ :rtype: dict
+ """
+
+ status_code, resp = HcUtil. \
+ get_honeycomb_data(node, "config_bgp_peer")
+ if status_code != HTTPCodes.OK:
+ raise HoneycombError(
+ "Not possible to get configuration information about BGP."
+ " Status code: {0}.".format(status_code))
+ return resp
+
+ @staticmethod
+ def get_bgp_peer(node, address):
+ """Get BGP configuration of the specified peer from the node.
+
+ :param node: Honeycomb node.
+ :param address: IP address of the peer.
+ :type node: dict
+ :type address: str
+ :returns: BGP peer configuration data.
+ :rtype: dict
+ """
+
+ path = "bgp-openconfig-extensions:neighbors/" \
+ "neighbor/{0}".format(address)
+ status_code, resp = HcUtil. \
+ get_honeycomb_data(node, "config_bgp_peer", path)
+ if status_code != HTTPCodes.OK:
+ raise HoneycombError(
+ "Not possible to get configuration information about the BGP"
+ " peer. Status code: {0}.".format(status_code))
+ return resp
+
+ @staticmethod
+ def add_bgp_peer(node, address, data):
+ """Configure a BGP peer on the node.
+
+ :param node: Honeycomb node.
+ :param address: IP address of the peer.
+ :param data: Peer configuration data.
+ :type node: dict
+ :type address: str
+ :type data: dict
+ :returns: Content of response.
+ :rtype: bytearray
+ """
+
+ path = "bgp-openconfig-extensions:neighbors/neighbor/{address}".format(
+ address=address)
+ return BGPKeywords._configure_bgp_peer(node, path, data)
+
+ @staticmethod
+ def remove_bgp_peer(node, address):
+ """Remove a BGP peer from the configuration.
+
+ :param node: Honeycomb node.
+ :param address: IP address of the peer.
+ :type node: dict
+ :type address: str
+ :returns: Content of response.
+ :rtype: bytearray
+ """
+
+ path = "bgp-openconfig-extensions:neighbors/neighbor/{address}".format(
+ address=address)
+ return BGPKeywords._configure_bgp_peer(node, path)
+
+ @staticmethod
+ def configure_bgp_route(node, peer_address, data, route_address,
+ index, ip_version):
+ """Configure a route for the BGP peer specified by peer IP address.
+
+ :param node: Honeycomb node.
+ :param peer_address: IP address of the BGP peer.
+ :param data: Route configuration data.
+ :param route_address: IP address of the route.
+ :param index: Index number of the route within specified peer.
+ :param ip_version: IP protocol version. ipv4 or ipv6
+ :type node: dict
+ :type peer_address: str
+ :type data: dict
+ :type route_address: str
+ :type index: int
+ :type ip_version: str
+ :returns: Content of response.
+ :rtype: bytearray
+ """
+
+ route_address = route_address.replace("/", "%2F")
+
+ if ip_version.lower() == "ipv4":
+ path = "{0}/tables/bgp-types:ipv4-address-family/" \
+ "bgp-types:unicast-subsequent-address-family/" \
+ "bgp-inet:ipv4-routes/ipv4-route/{1}/{2}" \
+ .format(peer_address, route_address, index)
+ else:
+ path = "{0}/tables/bgp-types:ipv6-address-family/" \
+ "bgp-types:unicast-subsequent-address-family/" \
+ "bgp-inet:ipv6-routes/ipv6-route/{1}/{2}" \
+ .format(peer_address, route_address, index)
+
+ return BGPKeywords._configure_bgp_route(node, path, data)
+
+ @staticmethod
+ def get_bgp_route(node, peer_address, route_address, index, ip_version):
+ """Get all BGP peers from operational data.
+
+ :param node: Honeycomb node.
+ :param peer_address: IP address of the BGP peer.
+ :param route_address: IP address of the route.
+ :param index: Index number of the route within specified peer.
+ :param ip_version: IP protocol version. ipv4 or ipv6
+ :type node: dict
+ :type peer_address: str
+ :type route_address: str
+ :type index: int
+ :type ip_version: str
+ :returns: Content of response.
+ :rtype: bytearray
+ :raises HoneycombError: If the operation fails.
+ """
+
+ route_address = route_address.replace("/", "%2F")
+
+ if ip_version.lower() == "ipv4":
+ path = "{0}/tables/bgp-types:ipv4-address-family/" \
+ "bgp-types:unicast-subsequent-address-family/" \
+ "bgp-inet:ipv4-routes/ipv4-route/{1}/{2}" \
+ .format(peer_address, route_address, index)
+ else:
+ path = "{0}/tables/bgp-types:ipv6-address-family/" \
+ "bgp-types:unicast-subsequent-address-family/" \
+ "bgp-inet:ipv6-routes/ipv6-route/{1}/{2}" \
+ .format(peer_address, route_address, index)
+ status_code, resp = HcUtil. \
+ get_honeycomb_data(node, "config_bgp_route", path)
+ if status_code != HTTPCodes.OK:
+ raise HoneycombError(
+ "Not possible to get configuration information about the BGP"
+ " route. Status code: {0}.".format(status_code))
+
+ return resp
+
+ @staticmethod
+ def get_all_peer_routes(node, peer_address, ip_version):
+ """Get all configured routes for the given BGP peer.
+
+ :param node: HOneycomb node.
+ :param peer_address: IP address of the peer.
+ :param ip_version: IP protocol version. ipv4 or ipv6
+ :type node: dict
+ :type peer_address: str
+ :type ip_version: str
+ :returns: Content of response.
+ :rtype: bytearray
+ :raises HoneycombError: If the operation fails.
+ """
+
+ if ip_version.lower() == "ipv4":
+ path = "{0}/tables/bgp-types:ipv4-address-family/" \
+ "bgp-types:unicast-subsequent-address-family/" \
+ "bgp-inet:ipv4-routes".format(peer_address)
+ else:
+ path = "{0}/tables/bgp-types:ipv6-address-family/" \
+ "bgp-types:unicast-subsequent-address-family/" \
+ "bgp-inet:ipv6-routes".format(peer_address)
+ status_code, resp = HcUtil. \
+ get_honeycomb_data(node, "config_bgp_route", path)
+ if status_code != HTTPCodes.OK:
+ raise HoneycombError(
+ "Not possible to get configuration information about BGP"
+ " routes. Status code: {0}.".format(status_code))
+
+ return resp
+
+ @staticmethod
+ def remove_bgp_route(node, peer_address, route_address, index, ip_version):
+ """Remove the specified BGP route from configuration.
+
+ :param node: Honeycomb node.
+ :param peer_address: IP address of the BGP peer.
+ :param route_address: IP address of the route.
+ :param index: Index number of the route within specified peer.
+ :param ip_version: IP protocol version. ipv4 or ipv6
+ :type node: dict
+ :type peer_address: str
+ :type route_address: str
+ :type index: int
+ :type ip_version: str
+ :returns: Content of response.
+ :rtype: bytearray
+ """
+
+ route_address = route_address.replace("/", "%2F")
+
+ if ip_version.lower() == "ipv4":
+ path = "{0}/tables/bgp-types:ipv4-address-family/" \
+ "bgp-types:unicast-subsequent-address-family/" \
+ "bgp-inet:ipv4-routes/ipv4-route/{1}/{2}" \
+ .format(peer_address, route_address, index)
+ else:
+ path = "{0}/tables/bgp-types:ipv6-address-family/" \
+ "bgp-types:unicast-subsequent-address-family/" \
+ "bgp-inet:ipv6-routes/ipv6-route/{1}/{2}" \
+ .format(peer_address, route_address, index)
+
+ return BGPKeywords._configure_bgp_route(node, path)