updated documentation

Author: omehrabi

docs/user_guide/connection.rst

@@ -1121,156 +1121,6 @@ the ``service_attributes`` parameter.
     456
 
 
-.. _unicon_credentials:
-
-Credentials
------------
-
-The ``credentials`` connection parameter defines a dictionary of named
-credentials.  A credential is a dictionary typically containing both
-``username`` and ``password`` keys.
-
-The ``login_creds`` connection parameter defines an optional sequence of
-credential names to try.  Each time the device prompts for a username or
-password, the current credential is set to the next credential in the sequence
-if a current credential has not already been set.
-When a password is sent, the current credential is unset.  The one exception
-is when entering an administrator's password on a routing device coming up
-without configuration, in this case the current credential is reused.
-If the sequence has been exhausted and no more credentials are available to
-satisfy a username/password prompt, a
-`CredentialsExhaustedError<unicon.core.errors.CredentialsExhaustedError>` is
-raised.
-
-Credentials are not retried, any username or password failure causes a
-`UniconAuthenticationError<unicon.core.errors.UniconAuthenticationError>`
-to be raised.
-
-It is possible to specify the password to use for routing devices to enter
-enable mode.  This may be done via the ``enable_password`` entry under the
-current credential, or via a separate credential called ``enable``.
-Please see :ref:`unicon_enable_password_handling` for details.
-
-Passwords specified as a :ref:`secret_strings` are automatically decoded prior
-to being sent to the device.
-
-In pyATS Testbed YAML
-"""""""""""""""""""""
-
-Credentials may be specified on a per-testbed, per-device or per-connection
-basis, as documented in :ref:`topology_credential_password_modeling`.
-
-
-.. code-block:: python
-
-    from pyats.topology import loader
-    tb = loader.load("""
-        devices:
-            my_device:
-                type: router
-                credentials:
-                    default:
-                        username: admin
-                        password: Cisc0123
-                    alternate:
-                        username: alt_username
-                        password: alt_password
-                    termserv:
-                        username: tsuser
-                        password: tspw
-                    enable:
-                        password: enablepw
-                connections:
-                    defaults: {class: 'unicon.Unicon'}
-                    a:
-                      protocol: ssh
-                      ip: 10.64.70.11
-                      port: 2042
-                      login_creds: [termserv, default]
-                      ssh_options: "-v -i /path/to/identityfile"
-
-    """)
-    dev = tb.devices.my_device
-    dev.connect()
-
-    # To connect using different credentials than is contained in the
-    # testbed YAML ``login_creds`` key:
-    dev.destroy()
-    dev.connect(login_creds=['termserv', 'alternate'])
-
-
-In Python
-"""""""""
-
-.. code-block:: python
-
-    dev = Connnection(hostname=uut_hostname,
-                       start=[uut_start_cmd],
-                       credentials={\
-                           {'default': {'username': 'admin', 'password': 'Cisc0123'}},\
-                           {'enable': {'password': 'enablepw'}},\
-                           {'termserv': {'username': 'tsuser', 'password': 'tspw'}},\
-                       },
-                       login_creds = ['termserv', 'default'],
-                     )
-
-
-Post credential action
-""""""""""""""""""""""
-
-In certain cases, e.g. when using a serial console server, an action is needed to get a response
-from the device connected to the serial port. There are two ways to configure this action.
-The first one is using a setting, the second one is using a post credential action.
-The post credential action takes precedence over the setting.
-
-Example credentials for a device.
-
-.. code-block:: yaml
-
-      my_device:
-          type: router
-          credentials:
-              default:
-                  username: admin
-                  password: Cisc0123
-              terminal_server:
-                  username: tsuser
-                  password: tspw
-
-
-Setting the credential action via `settings` in python.
-
-.. code-block:: python
-
-    # Name of the credential after which a "sendline()" should be executed
-    dev.settings.SENDLINE_AFTER_CRED = 'terminal_server'
-
-
-Settings can also be specified for the connection in the topology file as shown below.
-
-.. code-block:: yaml
-
-    connections:
-      cli:
-        settings:
-          SENDLINE_AFTER_CRED: terminal_server
-
-
-The post credential action supports ``send`` and ``sendline``, you can specify a string to be sent,
-e.g. `send( )` to send a space or `send(\\x03)` to send Ctrl-C. Quotes should not be specified.
-
-.. code-block:: yaml
-
-    connections:
-      cli:
-        login_creds: [terminal_server, default]
-        arguments:
-          cred_action:
-            terminal_server:
-              post: sendline()
-
-
-
 Logging
 -------
 
@@ -1694,10 +1544,10 @@ To make use of this feature, you can choose from the following actions:
             arguments:
               learn_tokens: True
 
-By default, token discovery will not overwrite tokens that you have already defined in your testbed file. 
+By default, token discovery will not overwrite tokens that you have already defined in your testbed file.
 It will only assign discovered tokens to the device object if the token does not yet exist or if the value is generic. For example: `platform: generic`.
 
-You can override this behavior if you'd like. Using the `overwrite_testbed_tokens` flag will cause any discovered token to be assigned to the device object regardless of what has been defined in the testbed. 
+You can override this behavior if you'd like. Using the `overwrite_testbed_tokens` flag will cause any discovered token to be assigned to the device object regardless of what has been defined in the testbed.
 This flag can be set in the same way as `learn_tokens`:
 
 1. Set the `overwrite_testbed_tokens` argument to True when calling `device.connect`