Файловый менеджер - Редактировать - /opt/imh-python/lib/python3.9/site-packages/pyeapi/__pycache__/client.cpython-39.pyc
Ðазад
a b�h�� � @ s, d Z ddlmZ ddlZddlZz ddlmZ ddlmZ W n* e yf ddlmZ ddlmZ Y n0 ddl m Z m Z mZ ddlmZmZ dd lmZ dd lmZmZ dd lmZ d d gZeeeeed�ZdZG dd� de�Ze� Zdd� Zdd� Z dd� Z dd� Z d%d d �Z G d!d"� d"e �Z!d#d$� Z"dS )&a Python Client for eAPI This module provides the client for eAPI. It provides the primary functions for building applications that work with Arista EOS eAPI-enabled nodes. The first function is to provide a client for sending and receiving eAPI request and response objects on a per node basis. The second function provides a library for building API enabled data models for configuring EOS nodes. This library allows for creating connections to EOS eAPI enabled nodes using the connect or connect_to function. Both functions will return an instance of a Node object that can be used to send and receive eAPI commands. The Node object can autoload API modules for a structured object oriented approach to configuring the EOS node with native Python objects. Example: >>> import pyeapi >>> conn = pyeapi.connect(host='10.1.1.1', transport='http') >>> conn.execute(['show version']) {u'jsonrpc': u'2.0', u'result': [{u'memTotal': 2028008, u'version': u'4.14.5F', u'internalVersion': u'4.14.5F-2209869.4145F', u'serialNumber': u'', u'systemMacAddress': u'00:0c:29:f5:d2:7d', u'bootupTimestamp': 1421765066.11, u'memFree': 213212, u'modelName': u'vEOS', u'architecture': u'i386', u'internalBuildId': u'f590eed4-1e66-43c6-8943-cee0390fbafe', u'hardwareRevision': u''}], u'id': u'4312565648'} >>> node = pyeapi.connect_to('veos01') >>> node.enable('show version') {u'jsonrpc': u'2.0', u'result': [{u'memTotal': 2028008, u'version': u'4.14.5F', u'internalVersion': u'4.14.5F-2209869.4145F', u'serialNumber': u'', u'systemMacAddress': u'00:0c:29:f5:d2:7d', u'bootupTimestamp': 1421765066.11, u'memFree': 213212, u'modelName': u'vEOS', u'architecture': u'i386', u'internalBuildId': u'f590eed4-1e66-43c6-8943-cee0390fbafe', u'hardwareRevision': u''}], u'id': u'4312565648'} Additionally the node object can automatically load API modules to work with the resources in the configuration. The API autoloader supports automatic loading of modules in pyeapi.api as well as provides the ability to build custom API modules to be loaded from a different namespace. Example: >>> import pyeapi >>> node = pyeapi.connect_to('veos01') >>> node.api('vlans').get(1) {'state': 'active', 'name': 'default', 'vlan_id': 1, 'trunk_groups': []} The API autoloader loads API modules by their filename. The following objects are provide in this module for creating clients to interface with eAPI. Node -- Creates an instance of a node object that represents a single EOS device. Each EOS device to be managed should have a Node instance Config -- A subclass of ConfigParser.SafeConfigParser that handles the configuration file. The configuration file is an INI style file that contains the settings for nodes used by the connect_to function. � )�uuid4N)� ConfigParser)�Error)�SafeConfigParser)� load_module� make_iterable�debug)�HttpEapiConnection�HttpsEapiConnection)�HttpsEapiCertConnection)�SocketEapiConnection�HttpLocalEapiConnection)� CommandErrorz ~/.eapi.confz/mnt/flash/eapi.conf)�socketZ http_local�http�httpsZ https_certsr c @ sf e Zd ZdZddd�Zedd� �Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dd� Z dd� ZdS )�Configa� Conifguration instance for managing the eapi.conf file. This class provides an instance for handling the configuration file. It should normally need to be instantiated. A single config object is instantiated by the module for working with the config. Attributes: filename (str): The full path to the loaded filename Args: filename(str): The full path to the filename to be loaded when the object is instantiated. Nc C s$ t �| � || _t� | _| �� d S �N)r �__init__�filename�dict�tags�autoload��selfr � r �}/root/rpmbuild/BUILDROOT/imh-python39-modules-3.9.7-92.el8.x86_64/opt/imh-python/lib/python3.9/site-packages/pyeapi/client.pyr � s zConfig.__init__c s dd� � � fdd�| � � D �S )zG Returns all of the loaded connections names as a list c S s t | ��dd�S )N� connection:� )�str�replace)�xr r r �<lambda>� � z$Config.connections.<locals>.<lambda>c s g | ] }� |��qS r r )�.0�name��connr r � <listcomp>� r# z&Config.connections.<locals>.<listcomp>)�sections�r r r& r � connections� s zConfig.connectionsc C st t t�}dtjv r tjd }n | jr*| j}t|�}|D ]0}tj�|�}tj�|�r6|| _| � |� S q6| � � dS )a� Loads the eapi.conf file This method will use the module variable CONFIG_SEARCH_PATH to attempt to locate a valid eapi.conf file if a filename is not already configured. This method will load the first eapi.conf file it finds and then return. The CONFIG_SEARCH_PATH can be overridden using an environment variable by setting EAPI_CONF. Z EAPI_CONFN) �list�CONFIG_SEARCH_PATH�os�environr r �path� expanduser�exists�read�_add_default_connection)r r0 r r r r r � s zConfig.autoloadc C s� zt �| |� W n> tyN } z&dt|�j|f }t|� W Y d}~n d}~0 0 | �� | �� D ]8}|�d�r`dt | � |��vr`| � |d|� d�d � q`| � � dS )aK Reads the file specified by filename This method will load the eapi.conf file specified by filename into the instance object. It will also add the default connection localhost if it was not defined in the eapi.conf file Args: filename (str): The full path to the file to load z'%s: parsing error in eapi conf file: %sNr �host�:� )r r3 �SafeConfigParserError�type�__name__r r4 r) � startswithr �items�set�split� generate_tags)r r �exc�msgr% r r r r3 � s � �z Config.readc C s | � d�s| jddd� dS )z�Checks the loaded config and adds the localhost profile if needed This method wil load the connection:localhost profile into the client configuration if it is not already present. � localhostr )� transportN)�get_connection�add_connectionr* r r r r4 � s z Config._add_default_connectionc C s| t � | _| �� D ]f}| �|d�r| �|d�}dd� |�d�D �D ]4}|| jvrZt� | j|< | j| �|�d�d � q@qdS )z7 Generates the tags with collection with hosts r c S s g | ]}t |��� �qS r )r �strip)r$ �tr r r r( � r# z(Config.generate_tags.<locals>.<listcomp>�,r6 r7 N)r r r) � has_option�getr> r, �append)r �sectionr �tagr r r r? � s zConfig.generate_tagsc C s || _ | �� dS )z�Loads the file specified by filename This method works in conjunction with the autoload method to load the file specified by filename. Args: filename (str): The full path to the file to be loaded N)r �reloadr r r r �load� s z Config.loadc C s$ | � � D ]}| �|� q| �� dS )z�Reloades the configuration This method will reload the configuration instance using the last known filename. Note this method will initially clear the configuration and reload all entries. N)r) �remove_sectionr )r rL r r r rN � s z Config.reloadc C s& d� |�}| �|�sdS t| �|��S )a Returns the properties for a connection name This method will return the settings for the configuration specified by name. Note that the name argument should only be the name. For instance, give the following eapi.conf file .. code-block:: ini [connection:veos01] transport: http The name to use to retrieve the configuration would be veos01 >>> pyeapi.client.config.get_connection('veos01') Args: name (str): The name of the connection to return Returns: A Python dictionary object of key/value pairs that represent the node configuration. If the name provided in the argument is not found, then None is returned. � connection:{}N)�format� has_sectionr r< )r r% r r r rD s zConfig.get_connectionc K sD d� |�}| �|� t|�� �D ]\}}| �|||� q | �� dS )a� Adds a connection to the configuration This method will add a connection to the configuration. The connection added is only available for the lifetime of the object and is not persisted. Note: If a call is made to load() or reload(), any connections added with this method must be re-added to the config instance Args: name (str): The name of the connection to add to the config. The name provided will automatically be prepended with the string connection: **kwargs (dict); The set of properties used to provide the node configuration rQ N)rR � add_sectionr, r< r= r? )r r% �kwargs�key�valuer r r rE ! s zConfig.add_connection)N)r: � __module__� __qualname__�__doc__r �propertyr+ r r3 r4 r? rO rN rD rE r r r r r s r c C s t �| �S )a Function method that loads a conf file This function will load the file specified by filename into the config instance. Its a convenience function that calls load on the config instance Args: filename (str): The full path to the filename to load )�configrO )r r r r � load_configA s r] c C s t �| �S )a Function to get settings for named config This function will return the settings for a specific connection as specified by name. Its a convenience function that calls get_connection on the global config instance Args: name (str): The name of the connection to return. The connection name is specified as the string right of the : in the INI file Returns: A Python dictionary object of key/value pairs that represent the nodes configuration settings from the config instance )r\ rD )r% r r r � config_forN s r^ c C s t j�| �S )a� Returns the hosts assocated with the specified tag This function will return the hosts assoicated with the tag specified in the argument. It will return an array of connecition names. Args: tag (str): The name of the tag to retrieve the list of hosts for Returns: list: A Python list object that includes the list of hosts assoicated with the specified tag. None: If the specified tag does not exist, then None is returned. )r\ r rJ )rM r r r � hosts_for_tag` s r_ c K s& | t vrtd��t | }|f i |��S )aD Creates a connection instance based on the transport This function creates the EapiConnection object based on the desired transport. It looks up the transport class in the TRANSPORTS global dictionary. Args: transport (string): The transport to use to create the instance. **kwargs: Arbitrary keyword arguments. Returns: An instance of a connection object based on the transport Raises: TypeError: A TypeError is raised if the transport keyword is not found in the list (keys) of available transports. zinvalid transport specified)� TRANSPORTS� TypeError)rC rU �klassr r r �make_connectionr s rc rB �adminr �< Fc K sL | pt } t| ||||||||d� } | rHt| f| |||||||d�| ��S | S )a� Creates a connection using the supplied settings This function will create a connection to an Arista EOS node using the arguments. All arguments are optional with default values. Args: transport (str): Specifies the type of connection transport to use. Valid values for the connection are socket, http_local, http, and https. The default value is specified in DEFAULT_TRANSPORT host (str): The IP addres or DNS host name of the connection device. The default value is 'localhost' username (str): The username to pass to the device to authenticate the eAPI connection. The default value is 'admin' password (str): The password to pass to the device to authenticate the eAPI connection. The default value is '' port (int): The TCP port of the endpoint for the eAPI connection. If this keyword is not specified, the default value is automatically determined by the transport type. (http=80, https=443) key_file (str): Path to private key file for ssl validation cert_file (str): Path to PEM formatted cert file for ssl validation ca_file (str): Path to CA PEM formatted cert file for ssl validation timeout (int): timeout return_node (bool): Returns a Node object if True, otherwise returns an EapiConnection object. Returns: An instance of an EapiConnection object for the specified transport. )r5 �username�password�key_file� cert_file�ca_file�port�timeout)rC r5 rf rg rh ri rj rk )�DEFAULT_TRANSPORTrc �Node) rC r5 rf rg rk rh ri rj rl � return_noderU � connectionr r r �connect� s !� ��rq c @ s� e Zd ZdZdd� Zdd� Zdd� Zedd � �Zed d � �Z ed d � �Z edd� �Z edd� �Z edd� �Z dd� Zdd� Zdd� Zdd� Zd d � Zd;d d �Zd<d$d%�Zd=d&d'�Zd>d)d*�Zd?d-d.�Zd/d0� Zd1d2� Zd3d4� Zd5d6� Zd7d8� Z d9d:� Z d,S )@rn a� Represents a single device for sending and receiving eAPI messages The Node object provides an instance for communicating with Arista EOS devices. The Node object provides easy to use methods for sending both enable and config commands to the device using a specific transport. This object forms the base for communicating with devices. Attributes: connection (EapiConnection): The connection property represents the underlying transport used by the Node object to communicate with the device using eAPI. running_config (str): The running-config from the device. This property is lazily loaded and refreshed over the life cycle of the instance. startup_config (str): The startup-config from the device. This property is lazily loaded and refreshed over the life cycle of the instance. autorefresh (bool): If True, the running-config and startup-config are refreshed on config events. If False, then the config properties must be manually refreshed. settings (dict): Provides access to the settings used to create the Node instance. Args: connection (EapiConnection): An instance of EapiConnection used as the transport for sending and receiving eAPI requests and responses. **kwargs: An arbitrary list of keyword arguments c K sN || _ d | _d | _d | _d | _d | _d | _|�d�| _|�dd�| _ || _ d S )NZ enablepwd� autorefreshT) � _connection�_running_config�_startup_config�_version�_version_number�_model� _session_namerJ � _enablepwdrr �settings)r rp rU r r r r � s z Node.__init__c C s dt | j� S �NzNode(connection=%s))r rs r* r r r �__str__� s z Node.__str__c C s dt | j� S r| )�reprrs r* r r r �__repr__� s z Node.__repr__c C s | j S r )rs r* r r r rp � s zNode.connectionc C s& | j d ur| j S | jddd�| _ | j S )N�allT)�params� as_string)rt � get_configr* r r r �running_config� s �zNode.running_configc C s& | j d ur| j S | jddd�| _ | j S )N�startup-configT)r� )ru r� r* r r r �startup_config� s �zNode.startup_configc C s | j r | j S | �� | j S r )rv �_get_version_propertiesr* r r r �version� s z Node.versionc C s | j r | j S | �� | j S r )rw r� r* r r r �version_number s zNode.version_numberc C s | j r | j S | �� | j S r )rx r� r* r r r �model s z Node.modelc C s� | � d�}t|d d d �| _t�dt|d d d ��}|rRt|�d��| _nt|d d d �| _t�dt|d d d ��}|r�t|�d��| _nt|d d d �| _dS ) z�Parses version and model information out of 'show version' output and uses the output to populate class properties. z show versionr �resultr� z[\d.\d]+z\d\d\d\dZ modelNameN) �enabler rv �re�match�grouprw �searchrx )r �outputr� r r r r� s z Node._get_version_propertiesc C s t |��� | _dS )a� Configures the enable mode authentication password EOS supports an additional password authentication mechanism for sessions that want to switch to executive (or enable) mode. This method will configure the password, if required, for entering executive mode Args: password (str): The password string in clear text used to authenticate to exec mode N)r rF rz )r rg r r r �enable_authentication# s zNode.enable_authenticationc K s* | j r| j|fi |��S | j|fi |��S )a� Configures the node with the specified commands This method is used to send configuration commands to the node. It will take either a string or a list and prepend the necessary commands to put the session into config mode. Args: commands (str, list): The commands to send to the node in config mode. If the commands argument is a string it will be cast to a list. The list of commands will also be prepended with the necessary commands to put the session in config mode. **kwargs: Additional keyword arguments for expanded eAPI functionality. Only supported eAPI params are used in building the request Returns: The config method will return a list of dictionaries with the output from each command. The function will strip the response from any commands it prepends. )ry �_configure_session�_configure_terminal)r �commandsrU r r r r\ 1 s z Node.configc K sJ t |�}t|�}|�dd� | j|fi |��}| jr<| �� |�d� |S )zZConfigures the node with the specified commands with leading "configure terminal" r zconfigure terminal)r r, �insert� run_commandsrr �refresh�pop�r r� rU �responser r r r� L s zNode._configure_terminalc K sP | j std��t|�}t|�}|�dd| j � | j|fi |��}|�d� |S )zhConfigures the node with the specified commands with leading "configure session <session name>" zNot currently in a sessionr zconfigure session %s)ry r r r, r� r� r� r� r r r r� ^ s zNode._configure_sessionr� c C s� |dv rt | |�}t�||tj�}|s.td��|jd \}}t�d||d� tj�}|s`td��|jd \}}|| }|||� S )a� Returns a section of the config Args: regex (str): A valid regular expression used to select sections of configuration to return config (str): The configuration to return. Valid values for config are "running_config" or "startup_config". The default value is "running_config" Returns: The configuration section as a string object. )r� r� zconfig section not foundr z^[^\s]Nzcould not find end block)�getattrr� r� �Mra �regs)r �regexr\ r� Z block_start�line_end�_Z block_endr r r rL p s z Node.section�jsonFTc K s t |�}d|v rtd��t� }|rf| j|||fi |��}t|�D ]"\}} |�t|| | | |d�� q@n�|D ]�} z2| j| ||fi |��} |�t| | d |d�� W qj t�y } zH| jdkr�| j| d|fi |��} |�t| | d dd�� n� W Y d} ~ qjd} ~ 0 0 qj|S ) a& Sends the array of commands to the node in enable mode This method will send the commands to the node and evaluate the results. If a command fails due to an encoding error, then the command set will be re-issued individual with text encoding. Args: commands (list): The list of commands to send to the node encoding (str): The requested encoding of the command output. Valid values for encoding are JSON or text strict (bool): If False, this method will attempt to run a command with text encoding if JSON encoding fails send_enable (bool): If True the enable command will be prepended to the command list automatically. **kwargs: Additional keyword arguments for expanded eAPI functionality. Only supported eAPI params are used in building the request Returns: A dict object that includes the response for each command along with the encoding Raises: TypeError: This method does not support sending configure commands and will raise a TypeError if configuration commands are found in the list of commands provided This method will also raise a TypeError if the specified encoding is not one of 'json' or 'text' CommandError: This method will raise a CommandError if any one of the commands fails. � configurez"config mode commands not supported)�commandr� r� �encodingr )r� r� r� i� �textN) r ra r, r� � enumeraterK r r Z error_code) r r� r� �strict� send_enablerU �results� responses�indexr� r� �respr@ r r r r� � sD '� � �� �� z Node.enablec K sr t |�}dd� |D �}|rB| jr6|�dd| jd�� n |�dd� | jj||fi |��}|rj|d �d� |d S )a� Sends the commands over the transport to the device This method sends the commands to the device using the nodes transport. This is a lower layer function that shouldn't normally need to be used, preferring instead to use config() or enable(). Args: commands (list): The ordered list of commands to send to the device using the transport encoding (str): The encoding method to use for the request and excpected response. send_enable (bool): If True the enable command will be prepended to the command list automatically. **kwargs: Additional keyword arguments for expanded eAPI functionality. Only supported eAPI params are used in building the request Returns: This method will return the raw response from the connection which is a Python dictionary object. c S s> g | ]6}d |v r6|� d �d d|� d �d �� d�n|�qS )z MULTILINE:r z%s r7 ��cmd�input)r> rF )r$ �cr r r r( � s ��z%Node.run_commands.<locals>.<listcomp>r r� r� r� )r rz r� rs �executer� )r r� r� r� rU r� r r r r� � s � zNode.run_commands� pyeapi.apic C s< t d�||��}t|d�r$|�| � t|d�r8|�| �S |S )a� Loads the specified api module This method is the API autoload mechanism that will load the API module specified by the name argument. The API module will be loaded and look first for an initialize() function and secondly for an instance() function. In both cases, the node object is passed to the module. Args: name (str): The name of the module to load. The name should be the name of the python file to import namespace (str): The namespace to use to load the module. The default value is 'pyeapi.api' Returns: The API module loaded with the node instance. z{}.{}� initialize�instance)r rR �hasattrr� r� )r r% � namespace�moduler r r �api s zNode.api�running-configNc C sb |dvrt d��d| }|r(|d| 7 }| �|d�}|rLt|d d ��� S t|d d ��d�S ) a: Retreives the config from the node This method will retrieve the config from the node as either a string or a list object. The config to retrieve can be specified as either the startup-config or the running-config. Args: config (str): Specifies to return either the nodes startup-config or running-config. The default value is the running-config params (str): A string of keywords to append to the command for retrieving the config. as_string (boo): Flag that determines the response. If True, then the configuration is returned as a raw string. If False, then the configuration is returned as a list. The default value is False Returns: This method will return either a string or a list depending on the states of the as_string keyword argument. Raises: TypeError: If the specified config is not one of either 'running-config' or 'startup-config' )r� r� z invalid config name specifiedzshow %sz %sr� r r� � )ra r� r rF r> )r r\ r� r� r� r� r r r r� $ s zNode.get_configc C s d| _ d| _dS )ad Refreshes the instance config properties This method will refresh the public running_config and startup_config properites. Since the properties are lazily loaded, this method will clear the current internal instance variables. One the next call the instance variables will be repopulated with the current config N)rt ru r* r r r r� K s z Node.refreshc C s | j p t� | _ dS )z Enter a config session N)ry r r* r r r �configure_sessionW s zNode.configure_sessionc C s | j dgdd�}|d d S )zReturns session-config diffs in text encoding Note: "show session-config diffs" doesn't support json encoding zshow session-config diffsr� )r� r r� �r� )r r� r r r �diff\ s z Node.diffc C s | � dg�S )z+Commits the current config session �commit)�_configure_and_exit_sessionr* r r r r� e s z Node.commitc C s | � dg�S )z*Aborts the current config session �abortr� r* r r r r� j s z Node.abortc K s* | j |fi |��}| jr | �� d | _|S r )r� rr r� ry r� r r r r� o s z Node._configure_and_exit_session)r� )r� FT)r� T)r� )r� NF) r: rX rY rZ r r} r r[ rp r� r� r� r� r� r� r� r\ r� r� rL r� r� r� r� r� r� r� r� r� r� r r r r rn � sH � L 3 � ' rn c C s* t | �}|std��tf ddi|��}|S )a� Creates a node instance based on an entry from the config This function will retrieve the settings for the specified connection from the config and return a Node instance. The configuration must be loaded prior to calling this function. Args: name (str): The name of the connection to load from the config. The name argument should be the connection name (everything right of the colon from the INI file) Returns: This function will return an instance of Node with the settings from the config instance. Raises: AttributeError: raised if the specified configuration name is not found in the loaded configuration z&connection profile not found in configro T)r^ �AttributeErrorrq )r% rU �noder r r � connect_to{ s r� ) NrB rd r NNNNre F)#rZ �uuidr r. r� � configparserr r r r8 � ImportErrorZ pyeapi.utilsr r r Zpyeapi.eapilibr r r r r r r- r` rm r r\ r] r^ r_ rc rq �objectrn r� r r r r �<module> sL = � @ � - G
| ver. 1.1 | |
.
| PHP 8.3.30 | Ð“ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ñ Ñтраницы: 0 |
proxy
|
phpinfo
|
ÐаÑтройка