Current File : //lib/python2.7/site-packages/salt/modules/freebsdpkg.pyo
�
���^c @@ s~ d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l
Z d d l Z d d l m
Z
m Z d d l m Z e j e � Z d Z d � Z d d d � Z d � Z d
� Z e j j j e d � Z d � Z d
� Z e e d � Z! d e d d d d � Z" d d d � Z# e j j j e# d � Z$ e j j j e# d � Z% d � Z& d � Z' d � Z( d S( u\
Remote package support using ``pkg_add(1)``
.. important::
If you feel that Salt should be using this module to manage packages on a
minion, and it is using a different module (or gives an error similar to
*'pkg.install' is not available*), see :ref:`here
<module-provider-override>`.
.. warning::
This module has been completely rewritten. Up to and including version
0.17.0, it supported ``pkg_add(1)``, but checked for the existence of a
pkgng local database and, if found, would provide some of pkgng's
functionality. The rewrite of this module has removed all pkgng support,
and moved it to the :mod:`pkgng <salt.modules.pkgng>` execution module. For
versions <= 0.17.0, the documentation here should not be considered
accurate. If your Minion is running one of these versions, then the
documentation for this module can be viewed using the :mod:`sys.doc
<salt.modules.sys.doc>` function:
.. code-block:: bash
salt bsdminion sys.doc pkg
This module acts as the default package provider for FreeBSD 9 and older. If
you need to use pkgng on a FreeBSD 9 system, you will need to override the
``pkg`` provider by setting the :conf_minion:`providers` parameter in your
Minion config file, in order to use pkgng.
.. code-block:: yaml
providers:
pkg: pkgng
More information on pkgng support can be found in the documentation for the
:mod:`pkgng <salt.modules.pkgng>` module.
This module will respect the ``PACKAGEROOT`` and ``PACKAGESITE`` environment
variables, if set, but these values can also be overridden in several ways:
1. :strong:`Salt configuration parameters.` The configuration parameters
``freebsdpkg.PACKAGEROOT`` and ``freebsdpkg.PACKAGESITE`` are recognized.
These config parameters are looked up using :mod:`config.get
<salt.modules.config.get>` and can thus be specified in the Master config
file, Grains, Pillar, or in the Minion config file. Example:
.. code-block:: yaml
freebsdpkg.PACKAGEROOT: ftp://ftp.freebsd.org/
freebsdpkg.PACKAGESITE: ftp://ftp.freebsd.org/pub/FreeBSD/ports/ia64/packages-9-stable/Latest/
2. :strong:`CLI arguments.` Both the ``packageroot`` (used interchangeably with
``fromrepo`` for API compatibility) and ``packagesite`` CLI arguments are
recognized, and override their config counterparts from section 1 above.
.. code-block:: bash
salt -G 'os:FreeBSD' pkg.install zsh fromrepo=ftp://ftp2.freebsd.org/
salt -G 'os:FreeBSD' pkg.install zsh packageroot=ftp://ftp2.freebsd.org/
salt -G 'os:FreeBSD' pkg.install zsh packagesite=ftp://ftp2.freebsd.org/pub/FreeBSD/ports/ia64/packages-9-stable/Latest/
.. note::
These arguments can also be passed through in states:
.. code-block:: yaml
zsh:
pkg.installed:
- fromrepo: ftp://ftp2.freebsd.org/
i ( t absolute_importt print_functiont unicode_literalsN( t CommandExecutionErrort MinionError( t sixu pkgc C@ s� t d d k r� t t d � d k r� i } d t k rE t d } n | r~ d | k r~ | d d k r~ t j d � t d f St St d
f S( u�
Load as 'pkg' on FreeBSD versions less than 10.
Don't load on FreeBSD 9 when the config option
``providers:pkg`` is set to 'pkgng'.
u osu FreeBSDu osreleasei
u providersu pkgu pkgngu] Configuration option 'providers:pkg' is set to 'pkgng', won't load old provider 'freebsdpkg'.ul The freebsdpkg execution module cannot be loaded: the configuration option 'providers:pkg' is set to 'pkgng'ur The freebsdpkg execution module cannot be loaded: either the os is not FreeBSD or the version of FreeBSD is >= 10.( t
__grains__t floatt __opts__t logt debugt Falset __virtualname__( t providers( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyt __virtual___ s &
"
c C@ s� | d k r | n t d d d � } | d k r7 | n t d d d � } i } | d k ri | | d <n | d k r� | | d <n | S( u
Return a list of tuples to seed the "env" list, which is used to set
environment variables for any pkg_add commands that are spawned.
If ``fromrepo`` or ``packagesite`` are None, then their corresponding
config parameter will be looked up with config.get.
If both ``fromrepo`` and ``packagesite`` are None, and neither
freebsdpkg.PACKAGEROOT nor freebsdpkg.PACKAGESITE are specified, then an
empty list is returned, and it is assumed that the system defaults (or
environment variables) will be used.
u
config.getu freebsdpkg.PACKAGEROOTu freebsdpkg.PACKAGESITEu PACKAGEROOTu PACKAGESITEN( t Nonet __salt__( t fromrepot packagesitet roott sitet ret( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyt _get_repo_optionsq s
c
C@ s� t d t � } g } g } t d d g d d d t �} xF | j � D]8 } y | j | j � d � WqG t k
r~ qG qG XqG Wg | D] } | | k r� | ^ q� } g } g } x� t | � t | � D]� }
| j |
� } | d
k r� t | � d k r | j d j |
| d � � qo| j |
� | j d
j |
d j
g | D] } d j |
| � ^ qG� � � q� q� Wt | � t | � t | � t | � } x$ | D] }
| j d j |
� � q�W| | | f S( u/
Since pkg_delete requires the full "pkgname-version" string, this function
will attempt to match the package name with its version. Returns a list of
partial matches and package names that match the "pkgname-version" string
required by pkg_delete, and a list of errors encountered.
t versions_as_listu cmd.run_stdoutu pkg_infot output_loglevelu tracet python_shelli i u {0}-{1}uJ Ambiguous package '{0}'. Full name/version required. Possible matches: {1}u , u Package '{0}' not foundN( t list_pkgst TrueR R t
splitlinest appendt splitt
IndexErrort sett getR t lent formatt join(
t namest pkgst errorst full_pkg_stringst outt linet xt full_matchest matchest ambiguoust namet cvert not_matched( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyt _match� s8
%
9*
c O@ s* t | � d k r d St d � | D� � S( ua
``pkg_add(1)`` is not capable of querying for remote packages, so this
function will always return results as if there is no package available for
install or upgrade.
CLI Example:
.. code-block:: bash
salt '*' pkg.latest_version <package name>
salt '*' pkg.latest_version <package1> <package2> <package3> ...
i u c s@ s | ] } | d f Vq d S( u N( ( t .0R+ ( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pys <genexpr>� s ( R" t dict( R% t kwargs( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyt latest_version� s
u available_versionc O@ s� | j d t � } t d | | � } t j j j | � s> | St | � d k rd i | | d 6} n t j d i � } t
g t j | � D]2 \ } } | i | j | d � d 6| d 6f ^ q� � S( u
Returns a string representing the package version or an empty string if not
installed. If more than one package name is specified, a dict of
name/version pairs is returned.
with_origin : False
Return a nested dictionary containing both the origin name and version
for each specified package.
.. versionadded:: 2014.1.0
CLI Example:
.. code-block:: bash
salt '*' pkg.version <package name>
salt '*' pkg.version <package1> <package2> <package3> ...
u with_originu pkg_resource.versioni i u
pkg.originu u originu version(
t popR R t saltt utilst datat is_trueR" t __context__R! R4 R t iteritems( R% R5 t with_originR t originsR+ t y( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyt version� s c C@ s t j j j t � t S( u�
``pkg_add(1)`` does not use a local database of available packages, so this
function simply returns ``True``. it exists merely for API compatibility.
CLI Example:
.. code-block:: bash
salt '*' pkg.refresh_db
( R8 R9 t pkgt
clear_rtagR R ( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyt
refresh_db� s c
K@ s^ t j j j | � } t g d D]$ } t j j j | j | � � ^ q � rP i Sd t k r� t j t d � } | s� t d | � n t j j j | � r� t j d i � } t
g t j | � D]2 \ } } | i | j | d � d 6| d 6f ^ q� � S| Si } i } t d d
d g d d
d t
�} t j d � } xz | j | � D]i \ } }
| sbqJn y | j d d � \ } } Wn t k
r�qJn Xt d | | | � |
| | <qJWt d | � t j | � t d <| t d <| s�t d | � n t j j j | � rZt
g t j | � D]2 \ } } | i | j | d � d 6| d 6f ^ q!� S| S( u`
List the packages currently installed as a dict::
{'<package_name>': '<version>'}
with_origin : False
Return a nested dictionary containing both the origin name and version
for each installed package.
.. versionadded:: 2014.1.0
CLI Example:
.. code-block:: bash
salt '*' pkg.list_pkgs
u removedu
purge_desiredu
pkg.list_pkgsu pkg_resource.stringifyu
pkg.originu u originu versionu cmd.run_stdoutu pkg_infou -aoR u traceR u, Information for ([^:]+):\s*Origin:\n([^\n]+)u -i u pkg_resource.add_pkgu pkg_resource.sort_pkglist( u removedu
purge_desired( R8 R9 R: R; t anyR! R< t copyt deepcopyR R4 R R= R t ret compilet findallt rsplitt
ValueError(
R R> R5 R+ R R? R@ R) t pkgs_reRB t origint pkgnamet pkgver( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyR sN 1 F
Fc K@ s� y# t d | | | | � \ } } Wn t k
rD } t | � � n X| sO i S| j d � } | rt | rt | } n t | | j d � � }
g } | d k r� | j d � n | j | � t � } t d d g | d |
d d
d t �}
|
d d
k r|
d r|
d g } n g } t j
d d � t � } t � t
j j j | | � } | r~t d d i | d 6| d 6�� n | S( u�
Install package(s) using ``pkg_add(1)``
name
The name of the package to be installed.
refresh
Whether or not to refresh the package database before installing.
fromrepo or packageroot
Specify a package repository from which to install. Overrides the
system default, as well as the PACKAGEROOT environment variable.
packagesite
Specify the exact directory from which to install the remote package.
Overrides the PACKAGESITE environment variable, if present.
Multiple Package Installation Options:
pkgs
A list of packages to install from a software repository. Must be
passed as a python list.
CLI Example:
.. code-block:: bash
salt '*' pkg.install pkgs='["foo", "bar"]'
sources
A list of packages to install. Must be passed as a list of dicts,
with the keys being package names, and the values being the source URI
or local path to the package.
CLI Example:
.. code-block:: bash
salt '*' pkg.install sources='[{"foo": "salt://foo.deb"}, {"bar": "salt://bar.deb"}]'
Return a dict containing the new package names and versions::
{'<package>': {'old': '<old-version>',
'new': '<new-version>'}}
CLI Example:
.. code-block:: bash
salt '*' pkg.install <package name>
u pkg_resource.parse_targetsu packagerootu packagesiteu
repositoryu -ru cmd.run_allu pkg_addt envR u traceR u retcodei u stderru
pkg.list_pkgsu) Problem encountered installing package(s)t infou errorsu changesN( R R R R! R R t extendR R R< R7 R t _rehashR8 R9 R: t
compare_dicts( R/ t refreshR R& t sourcesR5 t
pkg_paramst pkg_typet exct packagerootRQ t argst oldR) R' t newR ( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyt installB sB :
c
K@ sD y t d | | � d } Wn t k
r< } t | � � n Xt � } t g | D] } | ^ qP � \ } } x | D] } t j | � qr W| s� i St d d g | d d d t �}
|
d d k r� |
d r� |
d g } n g } t j d
d � t � } t j j
j | | � } | r@t d d i | d
6| d 6�� n | S( u6
Remove packages using ``pkg_delete(1)``
name
The name of the package to be deleted.
Multiple Package Options:
pkgs
A list of packages to delete. Must be passed as a python list. The
``name`` parameter will be ignored if this option is passed.
.. versionadded:: 0.16.0
Returns a dict containing the changes.
CLI Example:
.. code-block:: bash
salt '*' pkg.remove <package name>
salt '*' pkg.remove <package1>,<package2>,<package3>
salt '*' pkg.remove pkgs='["foo", "bar"]'
u pkg_resource.parse_targetsi u cmd.run_allu
pkg_deleteR u traceR u retcodeu stderru
pkg.list_pkgsu' Problem encountered removing package(s)RR u errorsu changesN( R R R R R2 R t errorR R< R7 R R8 R9 R: RU (
R/ R& R5 RX RZ R] R+ t targetsR' R` R) R^ R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyt remove� s2 %
u deleteu purgec C@ sD t d d � } | j d � d d k r@ t d d d d
�n d S(
u�
Recomputes internal hash table for the PATH variable. Use whenever a new
command is created during the current session.
u environ.getu SHELLu /i����u cshu tcshu cmd.shellu rehashR u traceN( u cshu tcsh( R R ( t shell( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyRT � s c G@ sK t | � } g } x( t j | d � D] } | j | � q& W| | d <| S( uV
List the files that belong to a package. Not specifying any packages will
return a list of _every_ file on the system's package database (not
generally recommended).
CLI Examples:
.. code-block:: bash
salt '*' pkg.file_list httpd
salt '*' pkg.file_list httpd postfix
salt '*' pkg.file_list
u files( t file_dictR t
itervaluesRS ( t packagesR t filest pkg_files( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyt file_list� s
c G@ sH g } i } | rG d } d d g g | D] } | j | � ^ q( } n d d g } t d | d d d t �} x% | d j � D] } | j | � q� Wd } x� | d
j � D]� } | d k r� | j d � r� | | j | � q� d | k r� | j d
d � \ } } | j d d � \ } }
| g | | <q� q� q� Wi | d 6| d 6S( uj
List the files that belong to a package, grouped by package. Not
specifying any packages will return a list of _every_ file on the
system's package database (not generally recommended).
CLI Examples:
.. code-block:: bash
salt '*' pkg.file_list httpd
salt '*' pkg.file_list httpd postfix
salt '*' pkg.file_list
u '{0}-[0-9]*'u pkg_infou -QLu -QLau cmd.run_allR u traceR u stderru stdoutu /u :/u :i u -u errorsu filesN( R# R R R R R t
startswithR RK ( Rf R' Rg t
match_patternt pt cmdR R* RB t fnt ver( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyRd s* /
() t __doc__t
__future__R R R RF t loggingRH t salt.utils.dataR8 t salt.utils.functoolst salt.utils.pkgt salt.exceptionsR R t salt.extR t getLoggert __name__R R R R R R2 R6 R9 t functoolst alias_functiont available_versionRA RD R R R_ Rb t deletet purgeRT Ri Rd ( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/freebsdpkg.pyt <module>J s< 1 " A f?
Mini Shell