File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/salt_version.cpython-310.pyc
Back
o ;jP � @ sj d Z ddlZddlZddlZddlmZ e�e�Z dZ dd� Zdd� Zd d � Z dd� Zd d� Zdd� ZdS )a� Access Salt's elemental release code-names. .. versionadded:: 3000 Salt's feature release schedule is based on the Periodic Table, as described in the :ref:`Version Numbers <version-numbers>` documentation. When a feature was added (or removed) in a specific release, it can be difficult to build out future-proof functionality that is dependent on a naming scheme that moves. For example, a state syntax needs to change to support an option that will be removed in the future, but there are many Minion versions in use across an infrastructure. It would be handy to use some Jinja syntax to check for these instances to perform one state syntax over another. A simple example might be something like the following: .. code-block:: jinja {# a boolean check #} {% set option_deprecated = salt['salt_version.less_than']("Sodium") %} {% if option_deprecated %} <use old syntax> {% else %} <use new syntax> {% endif %} � N)�CommandExecutionErrorZsalt_versionc C s t S )z) Only work on POSIX-like systems )�__virtualname__� r r �M/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/salt_version.py�__virtual__, s r c C s� t | t�s td��| �� } tjjj}|�| �}|du r#t � d| � dS z|d dkr3t � d| � W dS W n ty= Y nw d�d d � |D ��S )a� Returns the release number of a given release code name in a ``MAJOR.PATCH`` format (for Salt versions < 3000) or ``MAJOR`` for newer Salt versions. If the release name has not been given an assigned release number, the function returns a string. If the release cannot be found, it returns ``None``. name The release code name for which to find a release number. CLI Example: .. code-block:: bash salt '*' salt_version.get_release_number 'Oxygen' z 'name' argument must be a stringNzVersion %s not found.� r z>Version %s found, but no release number has been assigned yet.zNo version assigned.�.c s s � | ]}t |�V qd S )N)�str)�.0�itemr r r � <genexpr>Y s � z%get_release_number.<locals>.<genexpr>) � isinstancer r �lower�salt�version�SaltStackVersionZLNAMES�get�log�info� IndexError�join)�nameZversion_mapr r r r �get_release_number3 s&