cisco-config-parser 2.2.1__tar.gz → 2.2.3__tar.gz

{cisco_config_parser-2.2.1 → cisco_config_parser-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cisco_config_parser
-Version: 2.2.1
+Version: 2.2.3
 Summary: This library is used for Network Automation involving Cisco Routers and Switch. It will parse Cisco IOS, IOS-XE, IOS-XR, and NXOS configuration file into objects and/or json format
 Home-page: https://github.com/arezazadeh/cisco_config_parser
 Author: Ahmad Rezazadeh
@@ -26,7 +26,11 @@ pip install cisco-config-parser
 ## Classes in this library
 
 ```python
-IOSRouteParser
+IOSStaticRouteConfig
+IOSOSPFConfig
+IOSEIGRPConfig
+IOSBGPConfig
+IOSBGPConfig
 L3InterfaceParser
 L2InterfaceParser
 ParentChildParser
@@ -38,7 +42,7 @@ there more Classes are being built, and will be released in the upcoming version
 ```python
 from cisco_config_parser.helper import helper 
 
-helper = helper.IOSRouteParser()
+helper = helper.IOSStaticRouteConfig()
 
 print(helper)
 ```
@@ -55,50 +59,8 @@ with open("show_run.txt", "r") as file_output:
 
 obj = ConfigParser(content)
 
-
-#
-##
-###
-#### Static Routes Example:
-###
-##
-#
-obj.get_static_routes()
-obj.get_static_routes(return_json=True)
-
-
-#
-##
-###
-#### OSPF Example:
-###
-##
-#
-ospf = obj.get_ospf_config(return_json=True)
-ospf = obj.get_ospf_config()
-for i in ospf:
-    print(i.children)
-    print(i.network)
-    print(i.no_passive_interface)
-
-#
-##
-###
-#### EIGRP Example:
-###
-##
-#
-eigrp = obj.get_eigrp_config(return_json=True)
-eigrp = obj.get_eigrp_config()
-for i in eigrp:
-    print(i.children)
-    print(i.network)
-    print(i.vrf_children) << returns a list of EIGRPVrfChildren objects
-    vrf_children = i.vrf_children
-    for vrf in vrf_children:
-        print(vrf.network)
-        print(vrf.children)
-
+obj.get_static_routes() << Returns a list of objects
+obj.get_static_routes(return_json=True) << Returns a list of dictionaries 
 
 ```
 
@@ -109,7 +71,7 @@ for i in eigrp:
 - able to set custom regex and create dynamic method 
 
 
-* Example: 
+* L3Interface Example: 
 
 ```python
 from cisco_config_parser import ConfigParser

{cisco_config_parser-2.2.1 → cisco_config_parser-2.2.3}/README.md

@@ -16,7 +16,11 @@ pip install cisco-config-parser
 ## Classes in this library
 
 ```python
-IOSRouteParser
+IOSStaticRouteConfig
+IOSOSPFConfig
+IOSEIGRPConfig
+IOSBGPConfig
+IOSBGPConfig
 L3InterfaceParser
 L2InterfaceParser
 ParentChildParser
@@ -28,7 +32,7 @@ there more Classes are being built, and will be released in the upcoming version
 ```python
 from cisco_config_parser.helper import helper 
 
-helper = helper.IOSRouteParser()
+helper = helper.IOSStaticRouteConfig()
 
 print(helper)
 ```
@@ -45,50 +49,8 @@ with open("show_run.txt", "r") as file_output:
 
 obj = ConfigParser(content)
 
-
-#
-##
-###
-#### Static Routes Example:
-###
-##
-#
-obj.get_static_routes()
-obj.get_static_routes(return_json=True)
-
-
-#
-##
-###
-#### OSPF Example:
-###
-##
-#
-ospf = obj.get_ospf_config(return_json=True)
-ospf = obj.get_ospf_config()
-for i in ospf:
-    print(i.children)
-    print(i.network)
-    print(i.no_passive_interface)
-
-#
-##
-###
-#### EIGRP Example:
-###
-##
-#
-eigrp = obj.get_eigrp_config(return_json=True)
-eigrp = obj.get_eigrp_config()
-for i in eigrp:
-    print(i.children)
-    print(i.network)
-    print(i.vrf_children) << returns a list of EIGRPVrfChildren objects
-    vrf_children = i.vrf_children
-    for vrf in vrf_children:
-        print(vrf.network)
-        print(vrf.children)
-
+obj.get_static_routes() << Returns a list of objects
+obj.get_static_routes(return_json=True) << Returns a list of dictionaries 
 
 ```
 
@@ -99,7 +61,7 @@ for i in eigrp:
 - able to set custom regex and create dynamic method 
 
 
-* Example: 
+* L3Interface Example: 
 
 ```python
 from cisco_config_parser import ConfigParser

{cisco_config_parser-2.2.1 → cisco_config_parser-2.2.3}/cisco_config_parser/helper/help.py

@@ -1,8 +1,8 @@
 
 
-RTP_IOS_HELP = """
+RTP_IOS_STATIC_HELP = """
 
-Example Usage:
+Example Usage For Static Routes:
 ====================================================================================================
 
 with open("show_run.txt", "r") as file_output:
@@ -11,40 +11,51 @@ with open("show_run.txt", "r") as file_output:
 
 obj = ConfigParser(content)
 
+# Return it as a json object
+obj.get_static_routes(return_json=True)
 
-#
-##
-###
-#### Static Routes Example:
-###
-##
-#
+# or as a list of StaticRoute objects
 obj.get_static_routes()
-obj.get_static_routes(return_json=True)
+"""
+
 
+RTP_IOS_OSPF_HELP = """
 
-#
-##
-###
-#### OSPF Example:
-###
-##
-#
+Example Usage For OSPF Routes:
+====================================================================================================
+
+with open("show_run.txt", "r") as file_output:
+    content = file_output.read()
+
+
+obj = ConfigParser(content)
+
+# Return it as a json object
 ospf = obj.get_ospf_config(return_json=True)
+
+# or as a list of OSPFConfig objects
 ospf = obj.get_ospf_config()
 for i in ospf:
     print(i.children)
     print(i.network)
     print(i.no_passive_interface)
 
-#
-##
-###
-#### EIGRP Example:
-###
-##
-#
+"""
+RTP_IOS_EIGRP_HELP = """
+
+Example Usage For EIGRP Routes:
+====================================================================================================
+
+with open("show_run.txt", "r") as file_output:
+    content = file_output.read()
+
+
+obj = ConfigParser(content)
+
+# Return it as a json object
 eigrp = obj.get_eigrp_config(return_json=True)
+
+# or as a list of EIGRPConfig objects
 eigrp = obj.get_eigrp_config()
 for i in eigrp:
     print(i.children)
@@ -55,8 +66,38 @@ for i in eigrp:
         print(vrf.network)
         print(vrf.children)
 """
+
+
+RTP_IOS_BGP_HELP = """
+
+Example Usage For BGP Routes:
+====================================================================================================
+
+with open("show_run.txt", "r") as file_output:
+    content = file_output.read()
+
+
+obj = ConfigParser(content)
+
+# Return it as a json object
+bgp = obj.get_bgp_config(return_json=True)
+
+
+# or as a list of BGPConfig objects
+bgp = obj.get_bgp_config()
+for i in bgp:
+    print(i.children)
+    print(i.network)
+    print(i.vrf_children) << returns a list of BGPVrfChildren objects
+    vrf_children = i.vrf_children
+    for vrf in vrf_children:
+        print(vrf.network)
+        print(vrf.children)
+"""
+
 PARENT_CHILD_HELP = """
-Example Usage:
+
+Example Usage For Parent Child:
 ====================================================================================================
 
 with open("show_run.txt", "r") as file_output:
@@ -72,7 +113,8 @@ for i in parent_child:
 
 """
 LAYER3_INTERFACE_HELP = """
-Example Usage:
+
+Example Usage For Layer3 Interfaces:
 ====================================================================================================
 with open("show_run.txt", "r") as file_output:
     content = file_output.read()
@@ -101,9 +143,9 @@ for intf in l3_intfs:
     print(intf.load_interval) <<< dynamically creates an attribute based on the custom regex
 
 """
-
 LAYER2_INTERFACE_HELP = """
-Example Usage:
+
+Example Usage For Layer2 Interfaces:
 ====================================================================================================
 with open("show_run.txt", "r") as file_output:
     content = file_output.read()

cisco_config_parser-2.2.3/cisco_config_parser/helper/helper.py

@@ -0,0 +1,38 @@
+from .help import *
+
+
+class IOSStaticRouteConfig:
+    def __repr__(self):
+        return RTP_IOS_STATIC_HELP
+
+class IOSOSPFConfig:
+    def __repr__(self):
+        return RTP_IOS_OSPF_HELP
+
+
+class IOSEIGRPConfig:
+    def __repr__(self):
+        return RTP_IOS_EIGRP_HELP
+
+class IOSBGPConfig:
+    def __repr__(self):
+        return RTP_IOS_BGP_HELP
+
+
+class ParentChild:
+    def __repr__(self):
+        return PARENT_CHILD_HELP
+
+
+class L3Interface:
+    def __repr__(self):
+        return LAYER3_INTERFACE_HELP
+
+
+class L2Interface:
+    def __repr__(self):
+        return LAYER2_INTERFACE_HELP
+
+
+
+

{cisco_config_parser-2.2.1 → cisco_config_parser-2.2.3}/cisco_config_parser/parent_child/parent_child_parser.py

@@ -21,6 +21,7 @@ class ParentChildParser:
         return: list of ParentChild objects
         """
         custom_regex = kwargs.get("custom_regex", None)
+        return_json = kwargs.get("return_json", False)
         if not custom_regex:
             raise ValueError("custom_regex is required")
 
@@ -41,5 +42,8 @@ class ParentChildParser:
                     parent_child_obj.children = [line.strip() for line in child_regex if line] if child_regex else ""
                     parent_child_obj_list.append(parent_child_obj)
 
+        if return_json:
+            return [obj.__dict__ for obj in parent_child_obj_list]
+
         return parent_child_obj_list
 

{cisco_config_parser-2.2.1 → cisco_config_parser-2.2.3}/cisco_config_parser/parser/__init__.py

@@ -32,6 +32,15 @@ class ConfigParser(Parser):
         return self._get_eigrp_config(return_json=return_json)
 
 
+    def get_bgp_config(self, return_json=False):
+        """
+        Get the eigrp configuration from the config file
+        :return: list of eigrp objects or json
+        """
+        return self._get_bgp_config(return_json=return_json)
+
+
+
     def get_vlan_info(self):
         """
         Get the vlan information from the config file

{cisco_config_parser-2.2.1 → cisco_config_parser-2.2.3}/cisco_config_parser/parser/parser.py

@@ -2,7 +2,12 @@ from cisco_config_parser.layer3_interface import L3InterfaceParser
 from cisco_config_parser.layer2_interface import L2InterfaceParser
 from cisco_config_parser.parent_child import ParentChildParser
 from cisco_config_parser.global_search import GlobalParser
-from cisco_config_parser.routing_protocol.rtp_ios_parser import IOSRouteParser
+from cisco_config_parser.routing_protocol.ios.rtp_ospf import IOSOSPFConfig
+from cisco_config_parser.routing_protocol.ios.rtp_eigtp import IOSEIGRPConfig
+from cisco_config_parser.routing_protocol.ios.rtp_static import IOSStaticRouteConfig
+from cisco_config_parser.routing_protocol.ios.rtp_bgp import IOSBGPConfig
+
+
 from cisco_config_parser.parser_regex.regex import *
 
 
@@ -14,11 +19,10 @@ class Parser:
         self._l2_parser_obj = L2InterfaceParser(self._content)
         self._parent_child_parser_obj = ParentChildParser(self._content)
         self._global_parser_obj = GlobalParser(self._content)
-        self._routing_protocol_parser_obj = IOSRouteParser(self._content)
 
 
 
-    def determine_platform(self):
+    def determine_platform(self, TARGET_CLASS):
         """
         Determine the platform of the device
         IOS, NXOS, IOSXR
@@ -29,7 +33,7 @@ class Parser:
         """
 
         if IOS_PLATFORM_REGEX_1.search(self._content):
-            return IOSRouteParser
+            return TARGET_CLASS
 
         elif NXOS_PLATFORM_REGEX_1.search(self._content) or NXOS_PLATFORM_REGEX_2.search(self._content):
             return "NXOS"
@@ -57,12 +61,12 @@ class Parser:
             if user provides the platform, then use the platform to fetch the static routes
             """
             if "ios" in self._platform.lower():
-                return self._routing_protocol_parser_obj._fetch_static_route_config(return_json=return_json)
+                return IOSStaticRouteConfig(self._content)._fetch_static_route_config(return_json=return_json)
 
         """
         if platform is not provided, then use internal logic to determine the platform
         """
-        relevant_object = self.determine_platform()
+        relevant_object = self.determine_platform(IOSStaticRouteConfig)
         return relevant_object(self._content)._fetch_static_route_config(return_json=return_json)
 
 
@@ -76,12 +80,12 @@ class Parser:
             if user provides the platform, then use the platform to fetch the static routes
             """
             if "ios" in self._platform.lower():
-                return self._routing_protocol_parser_obj._fetch_ospf_config(return_json=return_json)
+                return IOSOSPFConfig(self._content)._fetch_ospf_config(return_json=return_json)
 
         """
         if platform is not provided, then use internal logic to determine the platform
         """
-        relevant_object = self.determine_platform()
+        relevant_object = self.determine_platform(IOSOSPFConfig)
         return relevant_object(self._content)._fetch_ospf_config(return_json=return_json)
 
 
@@ -96,15 +100,35 @@ class Parser:
             if user provides the platform, then use the platform to fetch the static routes
             """
             if "ios" in self._platform.lower():
-                return self._routing_protocol_parser_obj._fetch_eigrp_config(return_json=return_json)
+                return IOSEIGRPConfig(self._content)._fetch_eigrp_config(return_json=return_json)
 
         """
         if platform is not provided, then use internal logic to determine the platform
         """
-        relevant_object = self.determine_platform()
+        relevant_object = self.determine_platform(IOSEIGRPConfig)
         return relevant_object(self._content)._fetch_eigrp_config(return_json=return_json)
 
 
+    def _get_bgp_config(self, return_json=False):
+        """
+        Get the static routes from the config file
+        :return: list of static route objects
+        """
+        if self._platform:
+            """
+            if user provides the platform, then use the platform to fetch the static routes
+            """
+            if "ios" in self._platform.lower():
+                return IOSBGPConfig(self._content)._fetch_bgp_config(return_json=return_json)
+
+        """
+        if platform is not provided, then use internal logic to determine the platform
+        """
+        relevant_object = self.determine_platform(IOSBGPConfig)
+        return relevant_object(self._content)._fetch_bgp_config(return_json=return_json)
+
+
+
 
     def _get_vlan_info(self):
         """

{cisco_config_parser-2.2.1 → cisco_config_parser-2.2.3}/cisco_config_parser/parser_regex/regex.py

@@ -61,8 +61,6 @@ VLAN_REGEX = re.compile(r"^vlan\s([0-9]+)", flags=re.MULTILINE)
 
 # Routing Protocol
 RTP_REGEX = re.compile(r"^router\s(.*)", flags=re.MULTILINE)
-
-RTP_BGP_REGEX = re.compile(r"^router bgp", flags=re.MULTILINE)
 RTP_ISIS_REGEX = re.compile(r"^router isis", flags=re.MULTILINE)
 RTP_RIP_REGEX = re.compile(r"^router rip", flags=re.MULTILINE)
 
@@ -99,6 +97,31 @@ RTP_EIGRP_REGEX = re.compile(r"^router eigrp", flags=re.MULTILINE)
 RTP_IOS_EIGRP_VRF_REGEX = re.compile(r"\s+address-family\sipv4\svrf\s(\S+)", flags=re.MULTILINE)
 RTP_IOS_EIGRP_NETWORK_REGEX = re.compile(r"\s+network\s(\d+\.\d+\.\d+\.\d+)\s(\d+\.\d+\.\d+\.\d+)", flags=re.MULTILINE)
 
+# IOS ROUTING PROTOCOL - BGP
+RTP_BGP_REGEX = re.compile(r"^router bgp", flags=re.MULTILINE)
+RTP_BGP_ROUTER_ID_REGEX = re.compile(r"\s+bgp\srouter-id\s(\d+\.\d+\.\d+\.\d+)", flags=re.MULTILINE)
+RTP_IOS_BGP_VRF_REGEX = re.compile(r"\s+address-family\sipv4\svrf\s(\S+)", flags=re.MULTILINE)
+RTP_IOS_BGP_NETWORK_REGEX = re.compile(r"\s+network\s(\d+\.\d+\.\d+\.\d+)\smask\s(\d+\.\d+\.\d+\.\d+)", flags=re.MULTILINE)
+RTP_IOS_BGP_NEIGHBOR_IP_REGEX = re.compile(r"\s+neighbor\s(\d+\.\d+\.\d+\.\d+)\s(.*)", flags=re.MULTILINE)
+RTP_IOS_BGP_NEIGHBOR_REMOTE_AS_REGEX = re.compile(r"\s+neighbor\s(\d+\.\d+\.\d+\.\d+)\sremote-as\s(\d+)", flags=re.MULTILINE)
+RTP_IOS_BGP_NEIGHBOR_DESCR_REGEX = re.compile(r"\s+neighbor\s(\d+\.\d+\.\d+\.\d+)\sdescription\s(.*)", flags=re.MULTILINE)
+RTP_IOS_BGP_NEIGHBOR_UPDATE_SRC_REGEX = re.compile(r"\s+neighbor\s(\d+\.\d+\.\d+\.\d+)\supdate-source\s(.*)", flags=re.MULTILINE)
+RTP_IOS_BGP_NEIGHBOR_RM_INBOUND_REGEX = re.compile(r"\s+neighbor\s(\d+\.\d+\.\d+\.\d+)\sroute-map\s(.*)\sin", flags=re.MULTILINE)
+RTP_IOS_BGP_NEIGHBOR_RM_OUTBOUND_REGEX = re.compile(r"\s+neighbor\s(\d+\.\d+\.\d+\.\d+)\sroute-map\s(.*)\sout", flags=re.MULTILINE)
+
+RTP_IOS_BGP_PEER_GROUP_REGEX = re.compile(r"\s+neighbor\s(\S+)\speer-group$", flags=re.MULTILINE)
+RTP_IOS_BGP_PG_REMOTE_AS_REGEX = re.compile(r"\s+neighbor\s(.*)\sremote-as\s(\S+)", flags=re.MULTILINE)
+RTP_IOS_BGP_PG_UPDATE_SRC_REGEX = re.compile(r"\s+neighbor\s(.*)\supdate-source\s(\S+)", flags=re.MULTILINE)
+RTP_IOS_BGP_PG_RM_IN_REGEX = re.compile(r"\s+neighbor\s(.*)\sroute-map\s(\S+)\sin", flags=re.MULTILINE)
+RTP_IOS_BGP_PG_RM_OUT_REGEX = re.compile(r"\s+neighbor\s(.*)\sroute-map\s(\S+)\sout", flags=re.MULTILINE)
+RTP_IOS_BGP_PG_NEIGHBOR_REGEX = re.compile(r"\s+neighbor\s(\d+\.\d+\.\d+\.\d+)\speer-group(.*)", flags=re.MULTILINE)
+RTP_IOS_BGP_PG_NEIGHBOR_DESCR_REGEX = re.compile(r"\s+neighbor\s(\d+\.\d+\.\d+\.\d+)\sdescription(.*)", flags=re.MULTILINE)
+RTP_IOS_BGP_GLOBAL_IPV4_REGEX = re.compile(r"\s+address-family\sipv4$", flags=re.MULTILINE)
+
+RTP_IOS_BGP_REDISTRIBUTE_REGEX = re.compile(r"\s+(redistribute\s.*)", flags=re.MULTILINE)
+RTP_IOS_BGP_REDISTRIBUTE_W_RM_REGEX = re.compile(r"redistribute\s(\S+\s\S+|\S+)\s+route-map(.*)", flags=re.MULTILINE)
+RTP_IOS_BGP_REDISTRIBUTE_WO_RM_REGEX = re.compile(r"redistribute\s(\S+\s\S+|\S+)$", flags=re.MULTILINE)
+
 
 
 def find_vrf_section(vrf, item):

cisco_config_parser-2.2.3/cisco_config_parser/routing_protocol/__init__.py

@@ -0,0 +1,5 @@
+from cisco_config_parser.routing_protocol.utils.rtp_separator import IOSRoutingProtocolSeparator
+from .utils import *
+from .ios import *
+from .nxos import *
+from .xr import *

cisco_config_parser-2.2.3/cisco_config_parser/routing_protocol/ios/__init__.py

@@ -0,0 +1,6 @@
+
+from .rtp_bgp import *
+from .rtp_eigtp import *
+from .rtp_ospf import *
+from .rtp_static import *
+from .rtp_ios_rtp_obj import *