Merge pull request #670 from networktocode/release-1.14.0

Release 1.14.0

Author: jeffkala

docs/admin/release_notes/version_1.14.md

@@ -0,0 +1,28 @@
+# v1.14 Release Notes
+
+## Release Overview
+
+- Library mapping updates and fixes.
+- NIST library updates and fixes for CVE reporting.
+- Documentation fixes.
+- Palo Alto brace configuration fixes.
+
+## [v1.14.0] 2025-07
+
+### Added
+
+- [644](https://github.com/networktocode/netutils/pull/644) Add ability to get the lib mapper in a os centric view versus a lib centric view.
+- [646](https://github.com/networktocode/netutils/pull/646) Add Additional SROS Tests.
+- [649](https://github.com/networktocode/netutils/pull/649) Add RUNNING_CONFIG_MAPPER to help map platform to running configuration command.
+
+### Changed
+
+- [652](https://github.com/networktocode/netutils/pull/652) Flatbot OUI File Updates.
+- [653](https://github.com/networktocode/netutils/pull/653) Flatbot PROTOCOL File Updates.
+- [662](https://github.com/networktocode/netutils/pull/662) NIST library updates and fixes.
+
+### Fixed
+
+- [640](https://github.com/networktocode/netutils/pull/640) Fix documentation issues.
+- [641](https://github.com/networktocode/netutils/pull/641) Fix documentation for Jinja examples.
+- [651](https://github.com/networktocode/netutils/pull/651) Fix Palo set format config parsing for curly brace.

docs/requirements.txt

@@ -1,10 +1,9 @@
 mkdocs==1.6.0
-# Material for MkDocs theme
 mkdocs-material==9.5.32
-mkdocs-python-classy==0.1.3
-# Render custom markdown for version added/changed/remove notes
-mkdocs-version-annotations==1.0.0
-# Automatic documentation from sources, for MkDocs
-mkdocstrings==0.25.2
+markdown-version-annotations==1.0.1
+griffe==1.1.1
 mkdocstrings-python==1.10.8
-griffe==1.1.1
+mkdocstrings==0.25.2
+mkdocs-autorefs==1.2.0
+# Unique requirements
+mkdocs-python-classy==0.1.3

docs/user/include_jinja_list.md

@@ -91,6 +91,7 @@
 | regex_split | netutils.regex.regex_split |
 | regex_sub | netutils.regex.regex_sub |
 | longest_prefix_match | netutils.route.longest_prefix_match |
+| get_running_config_command | netutils.running_config.get_running_config_command |
 | uptime_seconds_to_string | netutils.time.uptime_seconds_to_string |
 | uptime_string_to_seconds | netutils.time.uptime_string_to_seconds |
 | vlanconfig_to_list | netutils.vlan.vlanconfig_to_list |

docs/user/lib_mapper/nist.md

@@ -1,9 +1,11 @@
 | NIST | | NORMALIZED |
 | ---------- | -- | ------ |
 | adaptive_security_appliance_software | → | cisco_asa |
+| arubaos | → | aruba_os |
 | eos | → | arista_eos |
 | ios | → | cisco_ios |
 | ios_xe | → | cisco_xe |
 | ios_xr | → | cisco_xr |
 | junos | → | juniper_junos |
-| nx-os | → | cisco_nxos |
+| nx-os | → | cisco_nxos |
+| pan-os | → | paloalto_panos |

docs/user/lib_mapper/nist_reverse.md

@@ -1,9 +1,11 @@
 | NORMALIZED | | NIST |
 | ---------- | -- | ------ |
 | arista_eos | → | eos |
+| aruba_os | → | arubaos |
 | cisco_asa | → | adaptive_security_appliance_software |
 | cisco_ios | → | ios |
 | cisco_nxos | → | nx-os |
 | cisco_xe | → | ios_xe |
 | cisco_xr | → | ios_xr |
-| juniper_junos | → | junos |
+| juniper_junos | → | junos |
+| paloalto_panos | → | pan-os |

docs/user/lib_use_cases_jinja_filters.md

@@ -6,15 +6,15 @@ Here is the current folder structure.
 ```bash
 .
 ├── jinja2_environment.py
-├── templates
-└── test.j2
+└── templates
+    └── test.j2
 ```
 
 Below is the code in the `test.j2` file.
 
 ```jinja
 
-IP Address + 200 = {{ "192.168.0.1/10" | ip_addition(200) }}
+IP Address + 200 = {{ "192.168.0.1" | ip_addition(200) }}
 
 ```
 Below is a code in the `jinja2_environment.py` folder.
@@ -70,9 +70,10 @@ When using these filters, you must specify an attribute of that given class. Her
 
 ```bash
 .
+.
 ├── jinja2_environment.py
-├── templates
-└── test.j2
+└── templates
+    └── test.j2
 ```
 
 Below is the code in the `test.j2` file.

docs/user/lib_use_cases_lib_mapper.md

@@ -20,7 +20,7 @@ sot_driver = device.platform.napalm_driver
 
 
 # Connect to device via Napalm
-driver = napalm.get_network_driver("ios")
+driver = napalm.get_network_driver(sot_driver)
 
 device = driver(
     hostname="device.name",
@@ -38,14 +38,28 @@ net_con = NTC(host=device.name, username="demo", password="secret", device_type=
 
 Another use case could be using an example like the above in an Ansible filter. That would allow you to write a filter utilizing whichever automation library you needed without having to store the driver for each one in your Source of Truth.
 
+There is also a dynamically built mapping that gives you all of the libraries given a normalized name, here is a condensed snippet to understand the data structure of `NAME_TO_ALL_LIB_MAPPER`:
+
+```python
+{
+    "cisco_ios": {
+        "ansible": "cisco.ios.ios",
+        "napalm": "ios",
+    },
+    "cisco_nxos": {
+        "ansible": "cisco.nxos.nxos",
+        "napalm": "nxos",
+    }
+}
+```
 
 ## Aerleon Mapper
 
---8<-- "docs/user/lib_mapper/aerleon.md
+--8<-- "docs/user/lib_mapper/aerleon.md"
 
 ## Reverse Aerleon Mapper
 
---8<-- "docs/user/lib_mapper/aerleon_reverse.md
+--8<-- "docs/user/lib_mapper/aerleon_reverse.md"
 
 ## Ansible Mapper
 
@@ -57,19 +71,19 @@ Another use case could be using an example like the above in an Ansible filter.
 
 ## Capirca Mapper
 
---8<-- "docs/user/lib_mapper/capirca.md
+--8<-- "docs/user/lib_mapper/capirca.md"
 
 ## Reverse Capirca Mapper
 
---8<-- "docs/user/lib_mapper/capirca_reverse.md
+--8<-- "docs/user/lib_mapper/capirca_reverse.md"
 
 ## DNA Center Mapper
 
---8<-- "docs/user/lib_mapper/dna_center.md
+--8<-- "docs/user/lib_mapper/dna_center.md"
 
 ## Reverse DNA Center Mapper
 
---8<-- "docs/user/lib_mapper/dna_center_reverse.md
+--8<-- "docs/user/lib_mapper/dna_center_reverse.md"
 
 ## Forward Networks Mapper
 
@@ -122,11 +136,11 @@ Another use case could be using an example like the above in an Ansible filter.
 
 ## NIST Mapper
 
---8<-- "docs/user/lib_mapper/nist.md
+--8<-- "docs/user/lib_mapper/nist.md"
 
 ## Reverse NIST Mapper
 
---8<-- "docs/user/lib_mapper/nist_reverse.md
+--8<-- "docs/user/lib_mapper/nist_reverse.md"
 
 ## PyATS Mapper
 

mkdocs.yml

@@ -69,6 +69,8 @@ extra:
       link: "https://twitter.com/networktocode"
       name: "Network to Code Twitter"
 markdown_extensions:
+  - "markdown_version_annotations":
+      admonition_tag: "???"
   - "admonition"
   - "toc":
       permalink: true
@@ -82,7 +84,6 @@ markdown_extensions:
   - "footnotes"
 plugins:
   - "search"
-  - "mkdocs-version-annotations"
   - "mkdocs-python-classy":
       classy_strategy: "subclass"
       classy_modules:

netutils/config/parser.py

@@ -1550,7 +1550,7 @@ def build_config_relationship(self) -> t.List[ConfigLine]:  # pylint: disable=to
 
         # if config is in palo brace format, convert to set
         if self.config_lines_only is not None:
-            for line in self.config_lines_only:
+            for line in self.config_lines_only.splitlines():
                 if line.endswith("{"):
                     _needs_conversion = True
         if _needs_conversion: