24.3.3 released

docs/source/conf.py

@@ -10,8 +10,8 @@
 author = 'Nokia'
 
 # The full version, including alpha/beta/rc tags
-version = '24.3.2'
-release = '24.3.2'
+version = '24.3.3'
+release = '24.3.3'
 
 
 # -- General configuration ---------------------------------------------------

docs/source/features/24.3.rst → docs/source/features/24.03.rst

@@ -1,6 +1,14 @@
 Release 24.3
 ************
 
+24.3.3
+######
+
+* No additional features
+
+.. Reviewed by PLM 20240509
+.. Reviewed by TechComms 20210510
+
 24.3.2
 ######
 

docs/source/index.rst

@@ -17,11 +17,11 @@ documentation will be updated accordingly.
 .. list-table::
    :header-rows: 0
 
-   * - pySROS release: 24.3.2
-   * - Document Number: 3HE 20087 AAAB TQZZA
+   * - pySROS release: 24.3.3
+   * - Document Number: 3HE 20087 AAAC TQZZA
 
-.. Reviewed by PLM 20240403
-.. Reviewed by TechComms 20240403
+.. Reviewed by PLM 20240509
+.. Reviewed by TechComms 20240510
 
 .. toctree::
    :maxdepth: 2

examples/convert_example.py

@@ -12,12 +12,12 @@
 # Import sys library
 import sys
 
-# Import the connect method from the management pySROS sub-module
-from pysros.management import connect
-
 # Import the exceptions that are referenced so they can be caught on error.
 from pysros.exceptions import ModelProcessingError
 
+# Import the connect method from the management pySROS sub-module
+from pysros.management import connect
+
 
 class Data:  # pylint: disable=too-few-public-methods
     """Create an object containing the input data in the required format

examples/filesystem_example.py

@@ -12,6 +12,7 @@
 # pylint: disable=broad-except, eval-used, unspecified-encoding
 
 import sys
+
 from pysros.management import connect, sros
 
 

examples/get_all_router_and_vprn.py

@@ -6,10 +6,10 @@
 
 """Example to get all routers and VPRNs"""
 
-
 import sys
-from pysros.management import connect
+
 from pysros.exceptions import ModelProcessingError
+from pysros.management import connect
 from pysros.pprint import Table  # pylint: disable=no-name-in-module
 
 credentials = {

examples/get_all_vprn_routes_with_nexthop_ipv4_address.py

@@ -6,10 +6,11 @@
 
 """Example to get all VPRN routes with a given next-hop IP address"""
 
-import sys
 import ipaddress
-from pysros.management import connect
+import sys
+
 from pysros.exceptions import ModelProcessingError
+from pysros.management import connect
 from pysros.pprint import Table  # pylint: disable=no-name-in-module
 
 credentials = {

examples/get_inventory_remotely.py

@@ -6,13 +6,14 @@
 
 """Example to show obtaining a hardware inventory of multiple devices"""
 
-# Import the required libraries
-import sys
 import ipaddress
 import json
-from pysros.management import connect, sros
-from pysros.exceptions import ModelProcessingError
 
+# Import the required libraries
+import sys
+
+from pysros.exceptions import ModelProcessingError
+from pysros.management import connect, sros
 
 # Global credentials dictionary for the purposes of this example.  Global variables
 # discouraged in operational applications.

examples/get_list_keys_usage.py

@@ -37,16 +37,13 @@ def get_connection():
     # Else if the application is executed remotely
     else:
         # Import sys for returning specific exit codes
-        import sys  # pylint: disable=import-outside-toplevel
-
         # Import getpass to read the password
         import getpass  # pylint: disable=import-outside-toplevel
+        import sys  # pylint: disable=import-outside-toplevel
 
         # Import the exceptions so they can be caught on error
         # pylint: disable=import-outside-toplevel
-        from pysros.exceptions import (
-            ModelProcessingError,
-        )
+        from pysros.exceptions import ModelProcessingError
 
         # Make sure we have the right number of arguments, the host can
         # be an IP address or a hostname

examples/make_connection.py

@@ -6,16 +6,15 @@
 
 """Example to show how to make a connection and handle exceptions"""
 
-
 # Import sys for returning specific exit codes
 import sys
 
-# Import the connect method from the management pySROS sub-module
-from pysros.management import connect
-
 # Import the exceptions that are referenced so they can be caught on error.
 from pysros.exceptions import ModelProcessingError
 
+# Import the connect method from the management pySROS sub-module
+from pysros.management import connect
+
 
 def get_connection(host=None, credentials=None):
     """Function definition to obtain a Connection object to a specific SR OS device

examples/make_connection_extended.py

@@ -42,16 +42,15 @@ def get_connection():
     # Else if the application is executed remotely
     else:
         # Import sys for returning specific exit codes
-        import sys
-
         # Import getpass to read the password
         import getpass
+        import sys
 
         # Import the exceptions so they can be caught on error
         # fmt: off
         from pysros.exceptions import ModelProcessingError
-        # fmt: on
 
+        # fmt: on
         # Make sure we have the right number of arguments, the host can
         # be an IP address or a hostname
         if len(sys.argv) != 2:

examples/make_connection_extended_with_argv.py

@@ -42,8 +42,8 @@ def get_remote_connection(my_username, my_host, my_password):
     # Import the exceptions so they can be caught on error
     # fmt: off
     from pysros.exceptions import ModelProcessingError
-    # fmt: on
 
+    # fmt: on
     # The try statement and except statements allow an operation
     # attempt with specific error conditions handled gracefully
     try:

examples/set_list.py

@@ -8,10 +8,10 @@
 
 # Import the required libraries
 import sys
-from pysros.management import connect
 
 # Import the exceptions so they can be caught on error.
 from pysros.exceptions import ModelProcessingError
+from pysros.management import connect
 
 
 def get_connection(host=None, credentials=None):

examples/set_user_example.py

@@ -7,15 +7,15 @@
 
 """Example to show how to set data"""
 
+import random
+import string
+
 # Import the required libraries
 import sys
-import string
-import random
-from pysros.management import connect
 
 # Import the exceptions so they can be caught on error.
 from pysros.exceptions import ModelProcessingError
-
+from pysros.management import connect
 
 # Global credentials dictionary for the purposes of this example.  Global variables
 # discouraged in operational applications.

examples/show_command_aliases.py

@@ -7,7 +7,7 @@
 # pylint: disable=import-error, import-outside-toplevel, line-too-long, too-many-branches, too-many-locals, too-many-statements
 
 """
-Tested on: SR OS 23.10.R2
+Tested on: SR OS 24.3.R1
 
 Show command aliaseses.
 
@@ -58,8 +58,8 @@ def get_remote_connection(my_username, my_host, my_password):
     # Import the exceptions so they can be caught on error
     # fmt: off
     from pysros.exceptions import ModelProcessingError
-    # fmt: on
 
+    # fmt: on
     # The try statement and except statements allow an operation
     # attempt with specific error conditions handled gracefully
     try:
@@ -99,11 +99,12 @@ def get_remote_connection(my_username, my_host, my_password):
 def show_command_aliases_output(connection_object):
     """Main function for the show_command_aliases command"""
 
-    bright_red = "\u001b[31;1m"
-    bright_green = "\u001b[32;1m"
-    bright_blue = "\u001b[34;1m"
-    bright_cyan = "\u001b[36;1m"
-    reset_color = "\u001b[0m"
+    bright_blue = "\033[1;34m"
+    bright_cyan = "\033[1;36m"
+    bright_green = "\033[1;32m"
+    bright_red = "\033[1;31m"
+    bright_yellow = "\033[1;33m"
+    reset_color = "\033[0m"
 
     # Get environment configuration data
     try:
@@ -155,7 +156,7 @@ def show_command_aliases_output(connection_object):
         ):
             print(
                 "Alias name    : "
-                + bright_cyan
+                + bright_blue
                 + alias_name
                 + reset_color
                 + " ("
@@ -168,11 +169,11 @@ def show_command_aliases_output(connection_object):
         else:
             print(
                 "Alias name    : "
-                + bright_cyan
+                + bright_blue
                 + alias_name
                 + reset_color
                 + " ("
-                + bright_red
+                + bright_yellow
                 + "disabled"
                 + reset_color,
                 end="",
@@ -246,15 +247,15 @@ def show_command_aliases_output(connection_object):
                 if mount_point == "global":
                     print(
                         "Availability  : "
-                        + bright_blue
+                        + bright_cyan
                         + alias_name
                         + reset_color
                         + " (global)"
                     )
                 else:
                     print(
                         "Availability  : "
-                        + bright_blue
+                        + bright_cyan
                         + mount_point.replace("/", "")
                         + " "
                         + alias_name
@@ -264,7 +265,7 @@ def show_command_aliases_output(connection_object):
                 if mount_point == "global":
                     print(
                         "              : "
-                        + bright_blue
+                        + bright_cyan
                         + alias_name
                         + reset_color
                         + " (global)"
@@ -283,15 +284,15 @@ def show_command_aliases_output(connection_object):
     print("-" * 80)
     print(
         "Total aliases : "
-        + bright_cyan
+        + bright_blue
         + str(num_admin_up_aliases + num_admin_down_aliases)
         + reset_color
         + " ("
         + bright_green
         + str(num_admin_up_aliases)
         + reset_color
         + " enabled, "
-        + bright_red
+        + bright_yellow
         + str(num_admin_down_aliases)
         + reset_color
         + " disabled, "

examples/show_event_summary.py

@@ -32,9 +32,9 @@
 
 """
 
+from pysros.exceptions import InternalError, InvalidPathError, SrosMgmtError
 from pysros.management import connect, sros
-from pysros.pprint import Table
-from pysros.exceptions import InvalidPathError, SrosMgmtError, InternalError
+from pysros.pprint import Table  # pylint: disable=no-name-in-module
 
 
 def get_connection():
@@ -56,16 +56,16 @@ def get_connection():
     # Else if the application is executed remotely
     else:
         # Import sys for returning specific exit codes
-        import sys  # pylint: disable=import-outside-toplevel
-
         # Import getpass to read the password
         import getpass  # pylint: disable=import-outside-toplevel
+        import sys  # pylint: disable=import-outside-toplevel
 
         # Import the exceptions so they can be caught on error
         # fmt: off
-        from pysros.exceptions import ModelProcessingError  # pylint: disable=import-error disable=import-outside-toplevel
-        # fmt: on
+        from pysros.exceptions import \
+            ModelProcessingError  # pylint: disable=import-error disable=import-outside-toplevel
 
+        # fmt: on
         # Make sure we have the right number of arguments, the host can
         # be an IP address or a hostname
         if len(sys.argv) != 2:

examples/show_log_event_summary.py

@@ -7,7 +7,7 @@
 # pylint: disable=line-too-long
 
 """
-Tested on: SR OS 23.10.R2
+Tested on: SR OS 24.3.R1
 
 Obtain a summary of the log event history on the node.
 
@@ -32,9 +32,9 @@
 
 """
 
+from pysros.exceptions import InternalError, InvalidPathError, SrosMgmtError
 from pysros.management import connect, sros
 from pysros.pprint import Table
-from pysros.exceptions import InvalidPathError, SrosMgmtError, InternalError
 
 
 def get_connection():
@@ -56,16 +56,16 @@ def get_connection():
     # Else if the application is executed remotely
     else:
         # Import sys for returning specific exit codes
-        import sys  # pylint: disable=import-outside-toplevel
-
         # Import getpass to read the password
         import getpass  # pylint: disable=import-outside-toplevel
+        import sys  # pylint: disable=import-outside-toplevel
 
         # Import the exceptions so they can be caught on error
         # fmt: off
-        from pysros.exceptions import ModelProcessingError  # pylint: disable=import-error disable=import-outside-toplevel
-        # fmt: on
+        from pysros.exceptions import \
+            ModelProcessingError  # pylint: disable=import-error disable=import-outside-toplevel
 
+        # fmt: on
         # Make sure we have the right number of arguments, the host can
         # be an IP address or a hostname
         if len(sys.argv) != 2: