Acl check (#290)

Co-authored-by: Jeff Kala <[email protected]>
Co-authored-by: Adam Byczkowski <[email protected]>

Author: 3 people

.bandit.yml

@@ -3,4 +3,4 @@
 exclude_dirs:
   - "./tests/"
   - "./docs/"
-  - "netutils/oui_mappings.py"
+  - "netutils/data_files/"

.github/workflows/ci.yml

@@ -204,10 +204,10 @@ jobs:
         run: "docker image ls"
       - name: "Run Tests"
         run: "poetry run invoke pytest"
-      - name: "Install Napalm"
-        run: "pip install napalm"
+      - name: "Install Optional Dependencies"
+        run: "poetry run poetry install --extras optionals"
       - name: "Run Optional Tests"
-        run: "poetry run pytest tests/unit/test_lib_helpers_optionals.py"
+        run: "poetry run pytest tests/unit/test_lib_helpers_optionals.py tests/unit/test_acl.py"
     needs:
       - "pylint"
   publish_gh:

docs/assets/acl-workflow.drawio

@@ -0,0 +1,5 @@
+# ACLs
+
+::: netutils.acl
+    options:
+        show_submodules: True

docs/dev/code_reference/acl.md

@@ -34,6 +34,7 @@
 | get_broadcast_address | netutils.ip.get_broadcast_address |
 | get_first_usable | netutils.ip.get_first_usable |
 | get_peer_ip | netutils.ip.get_peer_ip |
+| get_range_ips | netutils.ip.get_range_ips |
 | get_usable_range | netutils.ip.get_usable_range |
 | ip_addition | netutils.ip.ip_addition |
 | ip_subtract | netutils.ip.ip_subtract |
@@ -44,7 +45,10 @@
 | ipaddress_network | netutils.ip.ipaddress_network |
 | is_classful | netutils.ip.is_classful |
 | is_ip | netutils.ip.is_ip |
+| is_ip_range | netutils.ip.is_ip_range |
+| is_ip_within | netutils.ip.is_ip_within |
 | is_netmask | netutils.ip.is_netmask |
+| is_network | netutils.ip.is_network |
 | netmask_to_cidr | netutils.ip.netmask_to_cidr |
 | get_napalm_getters | netutils.lib_helpers.get_napalm_getters |
 | get_oui | netutils.mac.get_oui |

docs/dev/arch_decision.md renamed to docs/dev/dev_adr.md

@@ -26,7 +26,7 @@ Functions are grouped with like functions, such as IP or MAC address based funct
 - Protocol Mapper - Provides a mapping for protocol names to numbers and vice versa.
 - Regex - Provide convenience methods for regex to be used in Jinja2.
 - Route - Provides the ability to provide a list of routes and an IP Address and return the longest prefix matched route.
-- Time -Provides the ability to convert between integer time and string times.
+- Time - Provides the ability to convert between integer time and string times.
 - VLANs - Provide the ability to convert configuration into lists or lists into configuration.
 
 ## Examples

docs/images/acl-workflow.png

@@ -106,6 +106,7 @@ nav:
       - Jinja Filters: "user/lib_use_cases_jinja_filters.md"
       - Library Mapper: "user/lib_use_cases_lib_mapper.md"
       - Protocol Mapper: "user/lib_use_cases_protocol_mappers.md"
+      - ACL: "user/lib_use_cases_acl.md"
       - Upgrade Paths: "user/lib_upgrade_paths.md"
       - Getting Started: "user/lib_getting_started.md"
       - Frequently Asked Questions: "user/faq.md"
@@ -128,10 +129,12 @@ nav:
       - Contributing to the Library: "dev/contributing.md"
       - Development Environment: "dev/dev_environment.md"
       - Config Parser Development: "dev/dev_config.md"
+      - Arch Decision Records: "dev/dev_adr.md"
       - Code Attribution to the Library: "dev/attribution.md"
       - Code Reference:
           - "dev/code_reference/index.md"
           - ASN: "dev/code_reference/asn.md"
+          - ACL: "dev/code_reference/acl.md"
           - Bandwidth: "dev/code_reference/bandwidth.md"
           - Banner: "dev/code_reference/banner.md"
           - Configs: "dev/code_reference/configs.md"