cisco-config-parser 2.1__tar.gz → 2.2__tar.gz

{cisco_config_parser-2.1 → cisco_config_parser-2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cisco_config_parser
-Version: 2.1
+Version: 2.2
 Summary: This Package Will Parse Cisco IOS, IOS-XE, IOS-XR and NXOS Configuration File.
 Home-page: https://github.com/arezazadeh/cisco_config_parser
 Author: Ahmad Rezazadeh
@@ -12,7 +12,89 @@ Description-Content-Type: text/markdown
 ## This Package Will Parse Cisco IOS, IOS-XE, IOS-XR, and NXOS Configuration File.
 
 
-# New Version 2.0
+# New Version 2.0 
+
+## Classes in this library
+
+```python
+IOSRouteParser
+L3InterfaceParser
+L2InterfaceParser
+ParentChildParser
+```
+there more Classes are being built, and will be released in the upcoming versions. 
+
+## Get Example usage:
+
+```python
+from cisco_config_parser.helper import helper 
+
+helper = helper.IOSRouteParser()
+
+print(helper)
+```
+
+**Output**:
+```
+
+Example Usage:
+====================================================================================================
+
+with open("show_run.txt", "r") as file_output:
+    content = file_output.read()
+
+
+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)
+
+
+```
+
+
+
 
 ### 1. Layer3 Interfaces:
 - added interface details - returns dict of all layer3 interfaces
@@ -20,6 +102,7 @@ Description-Content-Type: text/markdown
 - platform agnostic 
 - able to set custom regex and create dynamic method 
 
+
 * Example: 
 
 ```python

{cisco_config_parser-2.1 → cisco_config_parser-2.2}/README.md

@@ -2,7 +2,89 @@
 ## This Package Will Parse Cisco IOS, IOS-XE, IOS-XR, and NXOS Configuration File.
 
 
-# New Version 2.0
+# New Version 2.0 
+
+## Classes in this library
+
+```python
+IOSRouteParser
+L3InterfaceParser
+L2InterfaceParser
+ParentChildParser
+```
+there more Classes are being built, and will be released in the upcoming versions. 
+
+## Get Example usage:
+
+```python
+from cisco_config_parser.helper import helper 
+
+helper = helper.IOSRouteParser()
+
+print(helper)
+```
+
+**Output**:
+```
+
+Example Usage:
+====================================================================================================
+
+with open("show_run.txt", "r") as file_output:
+    content = file_output.read()
+
+
+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)
+
+
+```
+
+
+
 
 ### 1. Layer3 Interfaces:
 - added interface details - returns dict of all layer3 interfaces
@@ -10,6 +92,7 @@
 - platform agnostic 
 - able to set custom regex and create dynamic method 
 
+
 * Example: 
 
 ```python

{cisco_config_parser-2.1 → cisco_config_parser-2.2}/cisco_config_parser/global_search/global_parser.py

@@ -52,4 +52,6 @@ class GlobalParser:
             ]
             vlan_objects.append(vlan_obj)
 
-        return vlan_objects
+        return vlan_objects
+
+

cisco_config_parser-2.2/cisco_config_parser/helper/help.py

@@ -0,0 +1,73 @@
+
+
+RTP_IOS_HELP = """
+
+Example Usage:
+====================================================================================================
+
+with open("show_run.txt", "r") as file_output:
+    content = file_output.read()
+
+
+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)
+"""
+PARENT_CHILD_HELP = """
+Example Usage:
+====================================================================================================
+
+with open("show_run.txt", "r") as file_output:
+    content = file_output.read()
+
+obj = ConfigParser(content)
+
+parent_child = obj.get_parent_child(custom_regex="(^snmp.*)|(^aaa.*)")
+
+for i in parent_child:
+    print(i.parent)
+    print(i.children)
+
+"""

cisco_config_parser-2.2/cisco_config_parser/helper/helper.py

@@ -0,0 +1,23 @@
+from .help import *
+
+
+class IOSRouteParser:
+    def __repr__(self):
+        return RTP_IOS_HELP
+
+
+
+class ParentChild:
+    def __repr__(self):
+        return PARENT_CHILD_HELP
+
+
+class L3Interface:
+    def __repr__(self):
+        return "L3 Interface Usage"
+
+
+
+
+
+

{cisco_config_parser-2.1 → cisco_config_parser-2.2}/cisco_config_parser/layer3_interface/l3_interface_obj.py

@@ -32,4 +32,5 @@ class L3Interface:
         """
         If the attribute is not found, return None
         """
-        return None
+        return None
+

{cisco_config_parser-2.1 → cisco_config_parser-2.2}/cisco_config_parser/layer3_interface/l3_interface_parser.py

@@ -1,8 +1,13 @@
+import json
+
 from .l3_interface_separator import L3InterfaceSeparator
 from .l3_interface_obj import L3Interface
 from .l3_section_parser import _L3SectionParser
 from cisco_config_parser.parser_regex.regex import *
 from dataclasses import dataclass
+import re, ipaddress
+
+
 
 
 
@@ -65,6 +70,7 @@ class L3InterfaceParser:
             if ip_address_regex:
                 l3_intf_cls = _L3SectionParser._parse_ip_address_line(**ip_address_kwargs)
 
+
             if sec_ip_address_regex:
                 # set the primary flag to False to indicate that the ip address is a secondary ip address
                 ip_address_kwargs["primary"] = False
@@ -102,5 +108,26 @@ class L3InterfaceParser:
         return l3_intf_objects
 
 
+    def _fetch_subnet_and_usage(self, include_subnet_count=False):
+        """
+        Fetch the subnet usage from the config file
+        return: dictionary of subnet usage
+        """
 
+        subnet_usage = {}
+        subnet_count = {}
+        l3_interfaces = self._fetch_l3_interfaces()
+        for i in l3_interfaces:
+            if i.subnet:
+                cidr = str(ipaddress.IPv4Network(i.subnet, strict=False).prefixlen)
+                subnet_usage[i.name] = i.subnet
+                if subnet_count.get(f"/{cidr}"):
+                    subnet_count[f"/{cidr}"] += 1
+                else:
+                    subnet_count[f"/{cidr}"] = 1
+
+        if include_subnet_count:
+            subnet_usage["subnet_count"] = subnet_count
+
+        return subnet_usage
 

{cisco_config_parser-2.1 → cisco_config_parser-2.2}/cisco_config_parser/layer3_interface/l3_section_parser.py

@@ -5,6 +5,8 @@ import ipaddress
 
 class _L3SectionParser:
 
+
+
     @classmethod
     def _parse_ip_address_line(cls, **kwargs):
         """
@@ -16,11 +18,34 @@ class _L3SectionParser:
         mask using the ipaddress module
         return: l3_interface_obj
         """
+
+        def process_ip_address_with_cidr(ip_address_with_cidr, obj):
+            """
+            Process the ip address with cidr
+            :param ip_address_with_cidr: str
+            :param obj: L3Interface object
+            :return:
+            """
+            ip_address_config = ip_address_with_cidr.split("/")
+            ip_addr = ip_address_config[0].strip()
+            cidr = ip_address_config[1].strip()
+            subnet_ = ipaddress.IPv4Network(f"{ip_addr}/{cidr}", strict=False)
+            obj.ip_address = ip_addr.strip()
+            obj.mask = str(subnet_.netmask)
+            obj.subnet = str(subnet_).strip()
+            return obj
+
         ip_address_line_regex = kwargs.get("ip_address_line_regex")
         l3_interface_obj = kwargs.get("l3_interface_obj")
         primary = kwargs.get("primary", True)
 
         ip_address_regex = [ip_group for ip_group in ip_address_line_regex.groups() if ip_group]
+
+        # Check if the ip address has a CIDR - 10.1.1.1/24
+        if "/" in ip_address_regex[0]:
+            l3_interface_obj = process_ip_address_with_cidr(ip_address_regex[0], l3_interface_obj)
+            return l3_interface_obj
+
         ip_address_section = ip_address_regex[0].split()
         ip_address = ip_address_section[0].strip()
         mask = ip_address_section[1].strip()

{cisco_config_parser-2.1 → cisco_config_parser-2.2}/cisco_config_parser/parser/__init__.py

@@ -4,8 +4,33 @@ from .parser import Parser
 
 
 class ConfigParser(Parser):
-    def __init__(self, _content):
-        super().__init__(_content)
+    def __init__(self, _content, platform=None):
+        super().__init__(_content, platform=platform)
+
+
+    def get_static_config(self, return_json=False):
+        """
+        Get the static routes from the config file
+        :return: list of static route objects
+        """
+        return self._get_static_config(return_json=return_json)
+
+
+    def get_ospf_config(self, return_json=False):
+        """
+        Get the ospf configuration from the config file
+        :return: list of ospf objects or json
+        """
+        return self._get_ospf_config(return_json=return_json)
+
+
+    def get_eigrp_config(self, return_json=False):
+        """
+        Get the eigrp configuration from the config file
+        :return: list of eigrp objects or json
+        """
+        return self._get_eigrp_config(return_json=return_json)
+
 
     def get_vlan_info(self):
         """
@@ -28,6 +53,15 @@ class ConfigParser(Parser):
         """
         return self._get_parent_child(**kwargs)
 
+
+    def get_subnet_and_usage(self, include_subnet_count=False):
+        """
+        Fetch the subnet usage from the config file
+        return: dictionary of subnet usage
+        """
+        return self._get_subnet_and_usage(include_subnet_count=include_subnet_count)
+
+
     def get_l3_interfaces(self, **kwargs):
         """
         Get L3 interfaces from the config file

cisco_config_parser-2.2/cisco_config_parser/parser/parser.py

@@ -0,0 +1,201 @@
+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.parser_regex.regex import *
+
+
+class Parser:
+    def __init__(self, _content, platform=None):
+        self._content = _content
+        self._platform = platform
+        self._l3_parser_obj = L3InterfaceParser(self._content)
+        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):
+        """
+        Determine the platform of the device
+        IOS, NXOS, IOSXR
+        :return: string
+        - IOS running_config will have "Current configuration : <digts> bytes" at the beginning
+        - NXOS running_config will have "!Command: show running-config" at the beginning or we can look for "feature" keyword
+        - IOSXR running_config will have "!! IOS XR Configuration 6.2.3" at the beginning or we can look for "prefix-set" or "route-policy" keyword
+        """
+
+        if IOS_PLATFORM_REGEX_1.search(self._content):
+            return IOSRouteParser
+
+        elif NXOS_PLATFORM_REGEX_1.search(self._content) or NXOS_PLATFORM_REGEX_2.search(self._content):
+            return "NXOS"
+
+        elif XR_PLATFORM_REGEX_1.search(self._content) \
+                or XR_PLATFORM_REGEX_2.search(self._content) \
+                or XR_PLATFORM_REGEX_3.search(self._content):
+            return "XR"
+
+        raise ValueError("""
+            ------------------------------------------------------------------------------------------------------
+                                Not able to determine the platform of the device. 
+            Please pass the platform='IOS' or platform='NXOS' or platform='XR' as an argument to the Parser class
+            ------------------------------------------------------------------------------------------------------
+            """)
+
+
+    def _get_static_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 self._routing_protocol_parser_obj._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()
+        return relevant_object(self._content)._fetch_static_route_config(return_json=return_json)
+
+
+    def _get_ospf_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 self._routing_protocol_parser_obj._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()
+        return relevant_object(self._content)._fetch_ospf_config(return_json=return_json)
+
+
+
+    def _get_eigrp_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 self._routing_protocol_parser_obj._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()
+        return relevant_object(self._content)._fetch_eigrp_config(return_json=return_json)
+
+
+
+    def _get_vlan_info(self):
+        """
+        Get the vlan information from the config file
+        :return: list of vlan objects
+        """
+        return self._global_parser_obj._fetch_vlan_info()
+
+
+    def _get_banner(self):
+        """
+        Get the banner from the config file
+        :return: banner object
+        """
+        return self._global_parser_obj._fetch_banner()
+
+    def _get_parent_child(self, **kwargs):
+        """
+        Get parent child from the config file
+        :return: list of parent child objects
+        """
+        return self._parent_child_parser_obj._fetch_parent_child(**kwargs)
+
+
+    def _get_subnet_and_usage(self, include_subnet_count=False):
+        """
+        Fetch the subnet usage from the config file
+        return: dictionary of subnet usage and subnet count
+        """
+
+        return self._l3_parser_obj._fetch_subnet_and_usage(include_subnet_count=include_subnet_count)
+
+
+    def _get_l3_interfaces(self, **kwargs):
+        """
+        Get L3 interfaces from the config file
+        :return: list of L3 interface objects
+        """
+        return self._l3_parser_obj._fetch_l3_interfaces(**kwargs)
+
+    def _get_l3_interface_details(self):
+        """
+        Get the L3 interface details
+        :return: dictionary of L3 interface details
+        """
+        l3_interfaces = self._get_l3_interfaces()
+
+        if not l3_interfaces:
+            return {}  # Return an empty dictionary if no interfaces are found
+
+        return {interface.name: interface.children for interface in l3_interfaces}
+
+    def _get_l2_access_interfaces(self, **kwargs):
+        """
+        Get L2 interfaces from the config file
+        :return: list of L2 interface objects
+        """
+        return self._l2_parser_obj._fetch_l2_access_interfaces(**kwargs)
+
+    def _get_l2_access_interface_details(self):
+        """
+        Get the L2 interface details
+        :return: dictionary of L2 interface details
+        """
+        l2_access_interfaces = self._get_l2_access_interfaces()
+
+        if not l2_access_interfaces:
+            return {}
+
+        return {interface.name: interface.children for interface in l2_access_interfaces}
+
+
+    def _get_l2_trunk_interfaces(self, **kwargs):
+        """
+        Get L2 interfaces from the config file
+        :return: list of L2 interface objects
+        """
+        return self._l2_parser_obj._fetch_l2_trunk_interfaces(**kwargs)
+
+    def _get_l2_trunk_interface_details(self):
+        """
+        Get the L2 interface details
+        :return: dictionary of L2 interface details
+        """
+        l2_trunk_interfaces = self._get_l2_trunk_interfaces()
+
+        if not l2_trunk_interfaces:
+            return {}
+
+        return {interface.name: interface.children for interface in l2_trunk_interfaces}
+
+
+
+