Current File : //usr/lib/python2.7/site-packages/salt/modules/git.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 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 Z d d l Z d d l Z d d l m Z m Z d d l m Z d d l m Z e j e � Z i d d 6Z! d � Z" e# d
� Z$ e% e% e% e% e& e% d � Z' d � Z( d
� Z) d � Z* d � Z+ d � Z, e% e% e% e% e& e# e& d e% d � Z- e% e% e% d � Z. e% d � Z/ e% d � Z0 d d e% e% e& e% d � Z1 d e% d e% e% e& e% d � Z2 e% d d e% e% e& e% d � Z3 e% e& d d e% e% e& e% d � Z4 e% e% d d e% e% e% e% e% e& d e% d � Z5 d d e% e% e% e& e% d � Z6 e% e% e% e& e% d � Z7 e% e% e% e% e& e% d � Z8 e j9 j: j; e8 d � Z< e% e% e% e% e% e& e% d! � Z= e% e% e% e% e& e% d" � Z> e% e% e& e% d# � Z? d e% e% e& e% d$ � Z@ e% e% d d e% e% e& e& e% e% d% �
ZA d& e% e% e& e% d' � ZB e% e& e% d d e% e% e% e& d e% d( � ZC e& e% e% e% d d e% e% e& e% d) �
ZD e% e% e% d* � ZE e& e% e% e& e% d+ � ZF e% e% e& e% d, � ZG e& e% e% e% d- � ZH e% d. e% d d e% e% e% e% e% e& e% d d/ �
ZI e% d d e% e% e% e& e% d0 � ZJ e% e& e& e& e% d d e% e% e& e% d1 � ZK e% e% e% e& e% d2 � ZL d d e% e% e% e& d e% d3 � ZM e% e% d d e% e% e% e& d e% d4 �
ZN d5 d d e% e% e& e% d6 � ZO d. e% e% e# e& e% d7 � ZP e& e& e% e% e% e% e% e& e% d d8 �
ZQ d. e% e% e% e% e% e% e% e& e% d9 �
ZR e% e% e# e& e% d: � ZS d d e% e% e% e& e% d; � ZT e% d d e% e% e& e% d< � ZU d e& e% e% e& e% d= � ZV d d e% e% e& e% d> � ZW d? d d e% e% e& e% d@ � ZX e% e% e& e% dA � ZY d d e% e% e% e& d e% dB � ZZ e% d d e% e% e& e% dC � Z[ d e% d d e% e% e& e% dD � Z\ e& dE � Z] e% e% e% e& d d e% e% e& e% dF �
Z^ e& e# e% d d e% e% e& e% dG � Z_ e% e% dH � Z` d S(I u
Support for the Git SCM
i ( t absolute_importt print_functiont unicode_literalsN( t SaltInvocationErrort CommandExecutionError( t LooseVersion( t sixu rmu rm_c C@ s- t j j j d � d k r% t d f St Sd S( u/
Only load if git exists on the system
u gitu; The git execution module cannot be loaded: git unavailable.N( t saltt utilst patht whicht Nonet Falset True( ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt __virtual__% s c C@ sL t d t � } t | � t d � k rH | rD t d | d � � n t St S( uJ
Ensure that we don't try to operate on worktrees in git < 2.5.0.
t versioninfou 2.5.0uK Worktrees are only supported in git 2.5.0 and newer (detected git version: u )( t versionR t
_LooseVersionR R
( t failhardt git_version( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt _check_worktree_support0 s c K@ sN t j j j | � } | j d t � } | rC t j j j | � n | d k rg | sv t d � � qv n t | | � } | d k r� | d k r� t
| t j � r� t j
| � } q� n d } d d g }
|
j t | | | | d | �� |
j | � |
j | � | d k r |
j | � n t |
d | d | d | d
| d t d | �S(
u�
Common code for config.get_* functions, builds and runs the git CLI command
and returns the result dict for the calling function to parse.
u globalu* 'cwd' argument required unless global=Trueu --get-regexpu gitu configt output_encodingt cwdt usert passwordt ignore_retcodeR N( R R t argst clean_kwargst popR t invalid_kwargsR R t _expand_patht
isinstanceR t string_typest text_typet extendt _which_git_configt appendt _git_run( t get_optt keyt value_regexR R R R R t kwargst global_t command( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt _config_getter? s8
c C@ s� y | r d | n d } Wn0 t k
rL | rC d t j | � n d } n Xy# t j j t j j | � | � SWn6 t k
r� t j j t j j | � t j | � � SXd S( u
Expand home directory
u ~N( t TypeErrorR R! t osR t joint
expandusert AttributeError( R R t to_expand( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyR q s
##
c C@ sw d } xj | rr | | k rr y! t j | � j t j @s; t SWn t k
rP t SX| } t j j | � \ } } q Wt S( u<
Check every part of path for executable permission
N(
R R. t statt st_modet S_IXOTHR t OSErrorR t splitR
( R t prevpatht _( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt _path_is_executable_others� s
c C@ s� | d k r g St | t � rr g } xF | D]> } t | t j � rT | j | � q, | j t j | � � q, W| St | t j � s� t j | � g } n t j j j
| � } t j j j | � } y | d d k r� | d SWn t
k
r� n X| S( uA
Common code to inspect opts and split them if necessary
i����u --N( R R t listR R R$ R! R R R t shlex_splitt datat decodet
IndexError( t optst new_optst item( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt _format_opts� s&
c C@ sR | rH t d t � } t | � t d � k rH t d j | � � � qH n t | � S( uc
Do a version check and make sure that the installed version of git can
support git -c
R u 1.7.2uD git_opts is only supported for git versions >= 1.7.2 (detected: {0})( R R R R t formatRC ( R@ t version_( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt _format_git_opts� s c C@ s� t j j t j d � t j d d d d d � t j j t j d � t j d d d d � g } xM | D]? } t j | � } | rd t j j | d � rd | d } Pqd qd Wd } | S( uK
Windows only: search for Git's bundled ssh.exe in known locations
u SystemDriveu Program Files*u Gitu usru binu ssh.exei N( R. R R/ t getenvt sept globt isfileR ( t globmaskst globmaskt ssh_exet ret( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt
_find_ssh_exe� s
u basec
K@ s i } | ryt j d d � } g }
g } t | t � sE | g } n d } x�| D]�} d | k rt j j j d � �3 t j j j � } | } t
d | | | � } Wd QX| s� t j d | � t
d | � qR q4| r4t
j | t
d | � d
� q4n3 t
d | � s4| j | � t j d | � qR n i | d 6} t
j j t
j j t j j j d
� � } d } t j j j � r�t � } | d k r�t d � � n | | d <| d 7} | | d <n | s�t | � r�| | d <n_ t j j j � } t j j j | | � t
j | d � t
j | t
d | � d
� | | d <d | k rt d | � r|
j d j | � � qR n t j d | � zV t
d | d | d | d | d | d t d t j j j! d | d | d | |
� } Wd | rRy" t
d | � t j" d! | � WqRt# k
r#qRt$ t f k
rN} t j% d" | | � qRXn | r�y" t
d | � t j" d# | � Wq�t# k
r�q�t$ t f k
r�} t j% d$ | | � q�Xn X| d% d& k r�| S| | r�d' n d( } | rR |
j t j j j! | � � qR qR W| rud) j d* j |
� � } | rf|
rG| d+ 7} n | d, j d- j | � � 7} n t | � � n | St
d | d | d | d | d | d t d t j j j! d | d | d | |
� } | d% d& k r�| S| rwt | t � rd. j | � n | } d/ j t j j j! | � � } | | r6d' n d( } | rh| d0 j t j j j! | � � 7} n t | � � n | Sd S(1 u-
simple, throw an exception with the error message on an error return code.
this function may be moved to the command module, spliced with
'cmd.run_all', and used as an alternative to 'cmd.run_all'. Some
commands don't return proper retcodes, so this can't replace 'cmd.run_all'.
u __cliu u salt://i? u cp.get_fileNu identity %s does not exist.u file.removeu file.user_to_uidi����u file.file_existsu GIT_IDENTITYu git/ssh-id-wrapperu3 Failed to find ssh.exe, unable to use identity fileu GIT_SSH_EXEu .batu GIT_SSHi@ u salt-callu ssh.key_is_encryptedu� Identity file {0} is passphrase-protected and cannot be used in a non-interactive command. Using salt-call from the minion will allow a passphrase-protected key to be used.u4 Attempting git authentication using identity file %su cmd.run_allR t runasR t envt python_shellt log_callbackR t redirect_stderrR u Removed ssh wrapper file %su( Failed to remove ssh wrapper file %s: %su Removed identity file %su% Failed to remove identity file %s: %su retcodei u stdoutu stderru0 Unable to authenticate using identity file:
{0}u
u
u2 The following identity file(s) were not found: {0}u , u u Command '{0}' failedu : {0}(& t __opts__t getR R; R R R t filest set_umaskt mkstempt __salt__t logt errorR. t chownR$ R t abspathR/ t templatest TEMPLATE_DIRNAMEt platformt
is_windowsRO R R: t copyfilet chmodt __utils__RD t infoR t urlt redact_http_basic_autht debugR1 R t warning( R+ R R R t identityR R RT t saltenvR R) RQ t _salt_clit errorst missing_keyst tmp_identity_filet id_filet _id_filet ssh_id_wrappert tmp_ssh_wrapperRM t resultt exct errt msgt
gitcommand( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyR% � s
#
c
C@ s/ t d d d g d | d | d | d | �d S( u=
Use git rev-parse to return the top level of a repo
u gitu rev-parseu --show-toplevelR R R R u stdout( R% ( R R R R ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt
_get_toplevel� s c C@ s� d | } | t k r� t | d d g d | d | d t d | �} t j j | � sg | | d f } n | d f } t j j | � t | <n t | S( u/
Helper to retrieve git config options
u git.config.R@ u --git-dirR R R R u config( t __context__t rev_parseR
R. R t isabsR/ ( R R R R t
contextkeyt git_dirt paths( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt _git_config� s
c C@ s[ | r
d g St t d t � � } | t d � k r; d g Sd t | | | d | �g Sd S( u�
Based on whether global or local config is desired, return a list of CLI
args to include in the git config command.
u --globalR u 1.7.10.2u --localu --fileR N( R R R R� ( R* R R R R RE ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyR# � s u c
C@ s� t | | � } d g t | � } | j d d g � | j g t | � D] } | d k rH | ^ qH � | j d | g � t | d | d | d | d | d
| �d S(
u9
.. versionchanged:: 2015.8.0
The ``--verbose`` command line argument is now implied
Interface to `git-add(1)`_
cwd
The path to the git checkout
filename
The location of the file/directory to add, relative to ``cwd``
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the ``add``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-add(1)`: http://git-scm.com/docs/git-add
CLI Examples:
.. code-block:: bash
salt myminion git.add /path/to/repo foo/bar.py
salt myminion git.add /path/to/repo foo/bar.py opts='--dry-run'
u gitu addu --verboseu -vu --R R R R R u stdout( u -vu --verbose( R RF R" RC R% (
R t filenameR@ t git_optsR R R R R+ t x( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt add� s K, u HEADc K@ s# t | | � } t | | � } t j j j | � } | j d d
� }
| ra t j j j | � n d g t | � } | j d � | d k r� | s� t
j j | � t
j
} n | j d | g � n |
r� | j d |
g � n | j d | | g � t | d | d | d
| d | d | �t S( uF
.. versionchanged:: 2015.8.0
Returns ``True`` if successful, raises an error if not.
Interface to `git-archive(1)`_, exports a tarball/zip file of the
repository
cwd
The path to be archived
.. note::
``git archive`` permits a partial archive to be created. Thus, this
path does not need to be the root of the git repository. Only the
files within the directory specified by ``cwd`` (and its
subdirectories) will be in the resulting archive. For example, if
there is a git checkout at ``/tmp/foo``, then passing
``/tmp/foo/bar`` as the ``cwd`` will result in just the files
underneath ``/tmp/foo/bar`` to be exported as an archive.
output
The path of the archive to be created
overwrite : False
Unless set to ``True``, Salt will over overwrite an existing archive at
the path specified by the ``output`` argument.
.. versionadded:: 2015.8.0
rev : HEAD
The revision from which to create the archive
format
Manually specify the file format of the resulting archive. This
argument can be omitted, and ``git archive`` will attempt to guess the
archive type (and compression) from the filename. ``zip``, ``tar``,
``tar.gz``, and ``tgz`` are extensions that are recognized
automatically, and git can be configured to support other archive types
with the addition of git configuration keys.
See the `git-archive(1)`_ manpage explanation of the
``--format`` argument (as well as the ``CONFIGURATION`` section of the
manpage) for further information.
.. versionadded:: 2015.8.0
prefix
Prepend ``<prefix>`` to every filename in the archive. If unspecified,
the name of the directory at the top level of the repository will be
used as the prefix (e.g. if ``cwd`` is set to ``/foo/bar/baz``, the
prefix will be ``baz``, and the resulting archive will contain a
top-level directory by that name).
.. note::
The default behavior if the ``--prefix`` option for ``git archive``
is not specified is to not prepend a prefix, so Salt's behavior
differs slightly from ``git archive`` in this respect. Use
``prefix=''`` to create an archive with no prefix.
.. versionchanged:: 2015.8.0
The behavior of this argument has been changed slightly. As of
this version, it is necessary to include the trailing slash when
specifying a prefix, if the prefix is intended to create a
top-level directory.
git_opts
Any additional options to add to git command itself (not the
``archive`` subcommand), in a single string. This is useful for passing
``-c`` to run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-archive(1)`: http://git-scm.com/docs/git-archive
CLI Example:
.. code-block:: bash
salt myminion git.archive /path/to/repo /path/to/archive.tar
u formatu gitu archiveu u --prefixu --formatu --outputR R R R R N( R R R R R R R R RF R$ R. R t basenameRH R" R% R
( R t outputt revt prefixR� R R R R R) t format_R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt archive" s, x
c C@ s� t | | � } d g t | � } | j d � | j t | � � | d k r^ | j | � n t | d | d | d | d | d | �t S( uc
Interface to `git-branch(1)`_
cwd
The path to the git checkout
name
Name of the branch on which to operate. If not specified, the current
branch will be assumed.
opts
Any additional options to add to the command line, in a single string
.. note::
To create a branch based on something other than HEAD, pass the
name of the revision as ``opts``. If the revision is in the format
``remotename/branch``, then this will also set the remote tracking
branch.
Additionally, on the Salt CLI, if the opts are preceded with a
dash, it is necessary to precede them with ``opts=`` (as in the CLI
examples below) to avoid causing errors with Salt's own argument
parsing.
git_opts
Any additional options to add to git command itself (not the ``branch``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-branch(1)`: http://git-scm.com/docs/git-branch
CLI Examples:
.. code-block:: bash
# Set remote tracking branch
salt myminion git.branch /path/to/repo mybranch opts='--set-upstream-to origin/mybranch'
# Create new branch
salt myminion git.branch /path/to/repo mybranch upstream/somebranch
# Delete branch
salt myminion git.branch /path/to/repo mybranch opts='-d'
# Rename branch (2015.8.0 and later)
salt myminion git.branch /path/to/repo newbranch opts='-m oldbranch'
u gitu branchR R R R R N( R RF R$ R" RC R R% R
( R t nameR@ R� R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt branch� s U
c @ s� t | | � } d g t | � } | j d � | rE | j d � n t � � � | j � � t � f d � d D� � }
| d k r� |
s� t d � � q� n
| j | � t | d | d | d
| d | d t d
| �d S( uS
Interface to `git-checkout(1)`_
cwd
The path to the git checkout
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the
``checkout`` subcommand), in a single string. This is useful for
passing ``-c`` to run git with temporary changes to the git
configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
rev
The remote branch or revision to checkout.
.. versionchanged:: 2015.8.0
Optional when using ``-b`` or ``-B`` in ``opts``.
force : False
Force a checkout even if there might be overwritten changes
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-checkout(1)`: http://git-scm.com/docs/git-checkout
CLI Examples:
.. code-block:: bash
# Checking out local local revisions
salt myminion git.checkout /path/to/repo somebranch user=jeff
salt myminion git.checkout /path/to/repo opts='testbranch -- conf/file1 file2'
salt myminion git.checkout /path/to/repo rev=origin/mybranch opts='--track'
# Checking out remote revision into new branch
salt myminion git.checkout /path/to/repo upstream/master opts='-b newbranch'
# Checking out current revision into new branch (2015.8.0 and later)
salt myminion git.checkout /path/to/repo opts='-b newbranch'
u gitu checkoutu --forcec 3@ s | ] } | � k Vq d S( N( ( t .0R� ( R@ ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pys <genexpr> s u -bu -Bu2 'rev' argument is required unless -b or -B in optsR R R R RT R u stdout( u -bu -BN(
R RF R$ RC R" t anyR R R% R
( R R� t forceR@ R� R R R R R+ t checkout_branch( ( R@ s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt checkout" s( V
c
C@ s^ t | | � } | s$ t d � � n y% t j j j | | | d t �} Wn% t k
rp }
t |
j � � � n Xd g t | � } | j
d � | j t | � � | j d | g � | d k r� | j
| � t j j | � s� t j | � n | } n+ | j
| � t j j j � s d n d } t | d | d | d | d
| d |
d | d
| �t S( u�
Interface to `git-clone(1)`_
cwd
Location of git clone
.. versionchanged:: 2015.8.0
If ``name`` is passed, then the clone will be made *within* this
directory.
url
The URL of the repository to be cloned
.. versionchanged:: 2015.8.0
Argument renamed from ``repository`` to ``url``
name
Optional alternate name for the top-level directory to be created by
the clone
.. versionadded:: 2015.8.0
opts
Any additional options to add to the command line, in a single string
git_opts
Any additional options to add to git command itself (not the ``clone``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
identity
Path to a private key to use for ssh URLs
.. warning::
Unless Salt is invoked from the minion using ``salt-call``, the
key(s) must be passphraseless. For greater security with
passphraseless private keys, see the `sshd(8)`_ manpage for
information on securing the keypair from the remote side in the
``authorized_keys`` file.
.. _`sshd(8)`: http://www.man7.org/linux/man-pages/man8/sshd.8.html#AUTHORIZED_KEYS_FILE_FORMAT
.. versionchanged:: 2015.8.7
Salt will no longer attempt to use passphrase-protected keys unless
invoked from the minion using ``salt-call``, to prevent blocking
waiting for user input.
Key can also be specified as a SaltStack file server URL, eg. salt://location/identity_file
.. versionchanged:: 2016.3.0
https_user
Set HTTP Basic Auth username. Only accepted for HTTPS URLs.
.. versionadded:: 20515.5.0
https_pass
Set HTTP Basic Auth password. Only accepted for HTTPS URLs.
.. versionadded:: 2015.5.0
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
saltenv
The default salt environment to pull sls files from
.. versionadded:: 2016.3.1
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-clone(1)`: http://git-scm.com/docs/git-clone
CLI Example:
.. code-block:: bash
salt myminion git.clone /path/to/repo_parent_dir git://github.com/saltstack/salt.git
u Missing 'url' argumentt
https_onlyu gitu cloneu --u /tmpR R R Rk R Rl R N( R R R R Rg t add_http_basic_authR
t
ValueErrort __str__RF R$ R" RC R R. R t existst makedirsRa Rb R% ( R Rg R� R@ R� R R Rk t
https_usert
https_passR Rl R Rv R+ t clone_cwd( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt clone� s< z
c
C@ s� t | | � } d g t | � } | j d d | g � | j t | � � | rg | j d | g � n t | d | d | d | d | d | �d
S( u
Interface to `git-commit(1)`_
cwd
The path to the git checkout
message
Commit message
opts
Any additional options to add to the command line, in a single string.
These opts will be added to the end of the git command being run.
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
The ``-m`` option should not be passed here, as the commit message
will be defined by the ``message`` argument.
git_opts
Any additional options to add to git command itself (not the ``commit``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
filename
The location of the file/directory to commit, relative to ``cwd``.
This argument is optional, and can be used to commit a file without
first staging it.
.. note::
This argument only works on files which are already tracked by the
git repository.
.. versionadded:: 2015.8.0
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-commit(1)`: http://git-scm.com/docs/git-commit
CLI Examples:
.. code-block:: bash
salt myminion git.commit /path/to/repo 'The commit message'
salt myminion git.commit /path/to/repo 'The commit message' filename=foo/bar.py
u gitu commitu -mu --R R R R R u stdout( R RF R" RC R% (
R t messageR@ R� R R R� R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt commit5 s X c
K@ s� | j d t � } t d | d | d | d | d | d | | �} | d d k rV d
S| d
j � } | rp | Sy | d SWn t k
r� d SXd
S( uq
Get the value of a key in the git configuration file
key
The name of the configuration key to get
.. versionchanged:: 2015.8.0
Argument renamed from ``setting_name`` to ``key``
cwd
The path to the git checkout
.. versionchanged:: 2015.8.0
Now optional if ``global`` is set to ``True``
global : False
If ``True``, query the global git configuration. Otherwise, only the
local git configuration will be queried.
.. versionadded:: 2015.8.0
all : False
If ``True``, return a list of all values set for ``key``. If the key
does not exist, ``None`` will be returned.
.. versionadded:: 2015.8.0
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Examples:
.. code-block:: bash
salt myminion git.config_get user.name cwd=/path/to/repo
salt myminion git.config_get user.email global=True
salt myminion git.config_get core.gitproxy cwd=/path/to/repo all=True
u allu --get-allR R R R R u retcodei u stdouti����u N( R R R, R t
splitlinesR? (
R' R R R R R R) t all_Ru RN ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt
config_get� s$ I
c
K@ s� t d | d | d | d | d | d | d | | �} i } | d d k rP | Sxd | d
j � D]R }
y |
j d d � \ } } Wn t k
r� qa n X| j | g � j | � qa W| S( uK
.. versionadded:: 2015.8.0
Get the value of a key or keys in the git configuration file using regexes
for more flexible matching. The return data is a dictionary mapping keys to
lists of values matching the ``value_regex``. If no values match, an empty
dictionary will be returned.
key
Regex on which key names will be matched
value_regex
If specified, return all values matching this regex. The return data
will be a dictionary mapping keys to lists of values matching the
regex.
.. important::
Only values matching the ``value_regex`` will be part of the return
data. So, if ``key`` matches a multivar, then it is possible that
not all of the values will be returned. To get all values set for a
multivar, simply omit the ``value_regex`` argument.
cwd
The path to the git checkout
global : False
If ``True``, query the global git configuration. Otherwise, only the
local git configuration will be queried.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Examples:
.. code-block:: bash
# Matches any values for key 'foo.bar'
salt myminion git.config_get_regexp /path/to/repo foo.bar
# Matches any value starting with 'baz' set for key 'foo.bar'
salt myminion git.config_get_regexp /path/to/repo foo.bar 'baz.*'
# Matches any key starting with 'user.'
salt myminion git.config_get_regexp '^user\.' global=True
u --get-regexpR( R R R R R u retcodei u stdoutN( R, R� R7 R R� t
setdefaultR$ (
R' R( R R R R R R) Ru RN t linet paramt value( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt config_get_regexp� s& J
u config_get_regexc K@ s� t j j j | � } | j d t � } | j d t � }
| rU t j j j | � n | d k ry |
s� t d � � q� n t | | � } t
d � | | f D� � r� t d � � n | d k rwt | t � sy | j
d � } Wqtt k
r t j | � j
d � } qtXqwg } xU t j j j | � D]> } t | t j � rT| j | � q,| j t j | � � q,W| } n d d g }
|
r�|
j d � n | d k rt j |
� } | r�| j d
� n
| j d � | j | | g � t | d | d
| d | d | d | �n� x� t | � D] \ } } t j |
� } | d k rY| j d � n
| j d
� | j | | g � t | d | d
| d | d | d | �q"Wt | d
| d | d | d | d | i t d 6|
d 6�S( u�
.. versionchanged:: 2015.8.0
Return the value(s) of the key being set
Set a key in the git configuration file
cwd
The path to the git checkout. Must be an absolute path, or the word
``global`` to indicate that a global key should be set.
.. versionchanged:: 2014.7.0
Made ``cwd`` argument optional if ``is_global=True``
key
The name of the configuration key to set
.. versionchanged:: 2015.8.0
Argument renamed from ``setting_name`` to ``key``
value
The value to set for the specified key. Incompatible with the
``multivar`` argument.
.. versionchanged:: 2015.8.0
Argument renamed from ``setting_value`` to ``value``
add : False
Add a value to a key, creating/updating a multivar
.. versionadded:: 2015.8.0
multivar
Set a multivar all at once. Values can be comma-separated or passed as
a Python list. Incompatible with the ``value`` argument.
.. versionadded:: 2015.8.0
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
global : False
If ``True``, set a global variable
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Examples:
.. code-block:: bash
salt myminion git.config_set user.email me@example.com cwd=/path/to/repo
salt myminion git.config_set user.email foo@bar.com global=True
u addu globalu* 'cwd' argument required unless global=Truec s@ s | ] } | d k Vq d S( N( R ( R� R� ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pys <genexpr>� s u/ Only one of 'value' and 'multivar' is permittedu ,u gitu configu --globalu --addu
--replace-allR R R R R i u allN( R R R R R R R R R R t allR R; R7 R1 R R! R= R> R R$ t copyR" R% t enumerateR� R
( R' R� t multivarR R R R R R) t add_R* t new_multivarRB t command_prefixR+ t idxt target( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt
config_setc sv T
c K@ s] t j j j | � } | j d t � } | j d t � } | rU t j j j | � n | d k ry | s� t d � � q� n t | | � } d d g }
| r� |
j
d � n
|
j
d � |
j t | | | | d | �� |
j
| � | d k r|
j
| � n t
|
d | d k r | n d d
| d | d | d
t d | �} | d } | d k r^t S| d k ryt d � � n� | d k rt | | d
| d | d | d | �d k r�t d j | � � � qYd j | � }
| d k r�|
d 7}
n t |
� � nX | d k r t d � � n= d j | | � }
| d rM|
d | d 7}
n t |
� � d S( u
.. versionadded:: 2015.8.0
Unset a key in the git configuration file
cwd
The path to the git checkout. Must be an absolute path, or the word
``global`` to indicate that a global key should be unset.
key
The name of the configuration key to unset
value_regex
Regular expression that matches exactly one key, used to delete a
single value from a multivar. Ignored if ``all`` is set to ``True``.
all : False
If ``True`` unset all values for a multivar. If ``False``, and ``key``
is a multivar, an error will be raised.
global : False
If ``True``, unset set a global variable. Otherwise, a local variable
will be unset.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Example:
.. code-block:: bash
salt myminion git.config_unset /path/to/repo foo.bar
salt myminion git.config_unset /path/to/repo foo.bar all=True
u allu globalu* 'cwd' argument required unless global=Trueu gitu configu --unset-allu --unsetR R R R R R u retcodei i u Section or key is invalidi u Key '{0}' does not existu# Multiple values exist for key '{0}'u( and value_regex matches multiple valuesi u The value_regex is invalidu< Failed to unset key '{0}', git config returned exit code {1}u stderru ; N( R R R R R R R R R R R$ R" R# R% R
R R� RD ( R' R( R R R R R R) R� R* R+ RN t retcodeRx ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt config_unset sf A
c C@ sM t | | � } d d d d g } t | d | d | d | d | d | �d
S( u�
Returns the current branch name of a local checkout. If HEAD is detached,
return the SHA1 of the revision which is currently checked out.
cwd
The path to the git checkout
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Example:
.. code-block:: bash
salt myminion git.current_branch /path/to/repo
u gitu rev-parseu --abbrev-refu HEADR R R R R u stdout( R R% ( R R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt current_branch� s . c C@ s� t | | � } d d g } t t d t � � t d � k rL | j d � n | j | � t | d | d | d | d | d
| �d S( uN
Returns the `git-describe(1)`_ string (or the SHA1 hash if there are no
tags) for the given revision.
cwd
The path to the git checkout
rev : HEAD
The revision to describe
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-describe(1)`: http://git-scm.com/docs/git-describe
CLI Examples:
.. code-block:: bash
salt myminion git.describe /path/to/repo
salt myminion git.describe /path/to/repo develop
u gitu describeR u 1.5.6u --alwaysR R R R R u stdout( R R R R R$ R% ( R R� R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt describe� s 5 !
c C@ s- | r | r t d � � n d g t | � } | j d � | j t | � � | d k r� t | t t f � r� y | j d � } Wq� t
k
r� t j | � j d � } q� Xn t
} t }
| rPt t d t
� � t d � k r� t d � � n t } t
}
| j d � x� g | | f D] } | r | ^ q D] } t j d | � q3Wn� | r�| j d
� | ry| j | � n | r�t j d | � q�n= x: g | | f D] } | r�| ^ q�D] } | j | � q�W| r�| j d � | j | � n t | d
| d | d | d | d |
d t d |
�d S( u�
.. versionadded:: 2015.8.12,2016.3.3,2016.11.0
Interface to `git-diff(1)`_
cwd
The path to the git checkout
item1 and item2
Revision(s) to pass to the ``git diff`` command. One or both of these
arguments may be ignored if some of the options below are set to
``True``. When ``cached`` is ``False``, and no revisions are passed
to this function, then the current working tree will be compared
against the index (i.e. unstaged changes). When two revisions are
passed, they will be compared to each other.
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the ``diff``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
no_index : False
When it is necessary to diff two files in the same repo against each
other, and not diff two different revisions, set this option to
``True``. If this is left ``False`` in these instances, then a normal
``git diff`` will be performed against the index (i.e. unstaged
changes), and files in the ``paths`` option will be used to narrow down
the diff output.
.. note::
Requires Git 1.5.1 or newer. Additionally, when set to ``True``,
``item1`` and ``item2`` will be ignored.
cached : False
If ``True``, compare staged changes to ``item1`` (if specified),
otherwise compare them to the most recent commit.
.. note::
``item2`` is ignored if this option is is set to ``True``.
paths
File paths to pass to the ``git diff`` command. Can be passed as a
comma-separated list or a Python list.
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-diff(1)`: http://git-scm.com/docs/git-diff
CLI Example:
.. code-block:: bash
# Perform diff against the index (staging area for next commit)
salt myminion git.diff /path/to/repo
# Compare staged changes to the most recent commit
salt myminion git.diff /path/to/repo cached=True
# Compare staged changes to a specific revision
salt myminion git.diff /path/to/repo mybranch cached=True
# Perform diff against the most recent commit (includes staged changes)
salt myminion git.diff /path/to/repo HEAD
# Diff two commits
salt myminion git.diff /path/to/repo abcdef1 aabbccd
# Diff two commits, only showing differences in the specified paths
salt myminion git.diff /path/to/repo abcdef1 aabbccd paths=path/to/file1,path/to/file2
# Diff two files with one being outside the working tree
salt myminion git.diff /path/to/repo no_index=True paths=path/to/file1,/absolute/path/to/file2
u; The 'no_index' and 'cached' options cannot be used togetheru gitu diffu ,R u 1.5.1u> The 'no_index' option is only supported in Git 1.5.1 and neweru
--no-indexuQ Revision '%s' ignored in git diff, as revisions cannot be used when no_index=Trueu --cachedu] Second revision '%s' ignored in git diff, at most one revision is considered when cached=Trueu --R R R R R RT R u stdoutN( R RF R$ R" RC R R R; t tupleR7 R1 R R! R R
R R R[ Rj R% ( R t item1t item2R@ R� R R t no_indext cachedR� R R+ R R R� R� ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt diff� sZ o
"
!
,
,
u .c C@ sS t | | � } d d d | g } t | d | d | d | d | d t d | �d
S( u�
.. versionadded:: 2019.2.0
Runs a ``git checkout -- <path>`` from the directory specified by ``cwd``.
cwd
The path to the git checkout
path
path relative to cwd (defaults to ``.``)
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
CLI Example:
.. code-block:: bash
salt myminion git.discard_local_changes /path/to/repo
salt myminion git.discard_local_changes /path/to/repo path=foo
u gitu checkoutu --R R R R RT R u stdout( R R% R
( R R R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt discard_local_changes� s . c C@ sY t | | � } d g t | � } | j d � | rE | j d � n | j g t | � D] }
|
d k rX |
^ qX � | r� | j | � n | d k rt | t t f � s� y | j d � } Wq� t
k
r� t j | � j d � } q� Xn t
j j j | � } | j | � n t | d | d | d | d | d
| d t d |
d
| �d } t j d � } i } x� t
j j j | d � D]� } | j | � } | r�| j � \ } } } } | j � } | d k r| d k r�d n d } | j | g � j | � qQ| d k r5i | d 6| d 6| j d i � | <qQ| j d g � j | � q�q�W| S( u�
.. versionchanged:: 2015.8.2
Return data is now a dictionary containing information on branches and
tags that were added/updated
Interface to `git-fetch(1)`_
cwd
The path to the git checkout
remote
Optional remote name to fetch. If not passed, then git will use its
default behavior (as detailed in `git-fetch(1)`_).
.. versionadded:: 2015.8.0
force
Force the fetch even when it is not a fast-forward.
.. versionadded:: 2015.8.0
refspecs
Override the refspec(s) configured for the remote with this argument.
Multiple refspecs can be passed, comma-separated.
.. versionadded:: 2015.8.0
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the ``fetch``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
identity
Path to a private key to use for ssh URLs
.. warning::
Unless Salt is invoked from the minion using ``salt-call``, the
key(s) must be passphraseless. For greater security with
passphraseless private keys, see the `sshd(8)`_ manpage for
information on securing the keypair from the remote side in the
``authorized_keys`` file.
.. _`sshd(8)`: http://www.man7.org/linux/man-pages/man8/sshd.8.html#AUTHORIZED_KEYS_FILE_FORMAT
.. versionchanged:: 2015.8.7
Salt will no longer attempt to use passphrase-protected keys unless
invoked from the minion using ``salt-call``, to prevent blocking
waiting for user input.
Key can also be specified as a SaltStack file server URL, eg. salt://location/identity_file
.. versionchanged:: 2016.3.0
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
saltenv
The default salt environment to pull sls files from
.. versionadded:: 2016.3.1
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-fetch(1)`: http://git-scm.com/docs/git-fetch
CLI Example:
.. code-block:: bash
salt myminion git.fetch /path/to/repo upstream
salt myminion git.fetch /path/to/repo identity=/root/.ssh/id_rsa
u gitu fetchu --forceu -fu ,R R R Rk R RT Rl R u stdoutuQ [\s*]*(?:([0-9a-f]+)\.\.([0-9a-f]+)|\[(?:new (tag|branch)|tag update)\])\s+(.+)->u
u tagu new tagsu new branchesu oldu newu updated branchesu updated tags( u -fu --forceN( R RF R$ R" RC R R R; R� R7 R1 R R! R R R= t stringifyR% R
t ret compilet itertoolst matcht groupst rstripR� ( R t remoteR� t refspecsR@ R� R R Rk R Rl R R+ R� R� t update_reRN R� R� t old_shat new_shat new_ref_typet ref_namet ref_key( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt fetch� sT z
,
' c C@ s\ t | | � } d g t | � } | j d � | rE | j d � n | d
k rj | j d j | � � n | d
k r� | j d j | � � n | d
k rt | t j � r� t | t � r� d t j | � } n* t | t j
� s� t j | � j � } n | j d j | � � n | j t
| � � | j | � t | d | d | d
| d |
�d S( uX
Interface to `git-init(1)`_
cwd
The path to the directory to be initialized
bare : False
If ``True``, init a bare repository
.. versionadded:: 2015.8.0
template
Set this argument to specify an alternate `template directory`_
.. versionadded:: 2015.8.0
separate_git_dir
Set this argument to specify an alternate ``$GIT_DIR``
.. versionadded:: 2015.8.0
shared
Set sharing permissions on git repo. See `git-init(1)`_ for more
details.
.. versionadded:: 2015.8.0
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the ``init``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-init(1)`: http://git-scm.com/docs/git-init
.. _`template directory`: http://git-scm.com/docs/git-init#_template_directory
CLI Examples:
.. code-block:: bash
salt myminion git.init /path/to/repo
# Init a bare repo (before 2015.8.0)
salt myminion git.init /path/to/bare/repo.git opts='--bare'
# Init a bare repo (2015.8.0 and later)
salt myminion git.init /path/to/bare/repo.git bare=True
u gitu initu --bareu --template={0}u --separate-git-dir={0}u 0u --shared={0}R R R R u stdoutN( R RF R$ R RD R R t
integer_typest boolR! R t lowerR" RC R% ( R t baret templatet separate_git_dirt sharedR@ R� R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt init� s. b
c
C@ s t | | � } y" t | d | d | d | �} Wn t k
rE t SXt j j | d � } y� t j j j
| d � �� } xz | D]r } t j j j | � } y | j
d d � \ } } Wn t k
r� t SX| d k r� t j j | � r� t St Sq� WWd QXWn t k
rt SXt S( uW
.. versionadded:: 2015.8.0
This function will attempt to determine if ``cwd`` is part of a
worktree by checking its ``.git`` to see if it is a file containing a
reference to another gitdir.
cwd
path to the worktree to be removed
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Example:
.. code-block:: bash
salt myminion git.is_worktree /path/to/repo
R R R u .gitu ri u gitdir:N( R Rz R R R. R R/ R R RW t fopent stringutilst
to_unicodeR7 R R� R} R
t IOError(
R R R R t toplevelt gitdirt fp_R� t labelR ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt is_worktree s* *
c C@ sk t | | � } d d d d d j | s- d n d � g } t | d | d | d
| d | d | �d
j � S( u�
.. versionadded:: 2015.8.0
Return a list of branches
cwd
The path to the git checkout
remote : False
If ``True``, list remote branches. Otherwise, local branches will be
listed.
.. warning::
This option will only return remote branches of which the local
checkout is aware, use :py:func:`git.fetch
<salt.modules.git.fetch>` to update remotes.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Examples:
.. code-block:: bash
salt myminion git.list_branches /path/to/repo
salt myminion git.list_branches /path/to/repo remote=True
u gitu for-each-refu --formatu %(refname:short)u refs/{0}/u headsu remotesR R R R R u stdout( R RD R% R� ( R R� R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt
list_branchesX s ; c C@ sV t | | � } d d d d d g } t | d | d | d | d | d
| �d j � S( up
.. versionadded:: 2015.8.0
Return a list of tags
cwd
The path to the git checkout
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Examples:
.. code-block:: bash
salt myminion git.list_tags /path/to/repo
u gitu for-each-refu --formatu %(refname:short)u
refs/tags/R R R R R u stdout( R R% R� ( R R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt list_tags� s / c ( K@ s� t d t � s i St | | � } t j j j | � } | j d t � } | re t j j j | � n | r� | r� t
d � � n d4 d4 d4 d � } d � } d � } d5 }
i } t t
d
t � � } | t d � k }
|
r�t d d d
d g d | d | d | d | �} | d d k rVd } | d rG| d j | d � 7} n t
| � � n d � } xbt j j j | d j � d � D]>} t g |
D] } | d f ^ q�� } x� t j j j | d � D]� } y" | j � j d4 d � \ } } Wn9 t k
r)| d k rd } d } q*| | � q�n X| |
k rF| | � q�n | | rit j d | | � q�n | | | <q�Wg |
D] } | | s~| ^ q~} | r�t j d d! j | � | � q�n t j j | d � } | | | | � s�q�n | d | k r| | d � n | j | d i � } | | d" <| d | d <| d d k | d <| d r�d4 | d <| | | d d | d | d | �} | r�| | d# <q�q�| d j d$ d d � | d <q�W| St | d | d | d | �} y. t | d% d& d' g d | d | d | �} Wn? t
k
rU} d( | } t j | d) t j �t
| � � n X| j! d* � r}t j j | | � } n t j j | � s�t
d+ j | � � � n d, � } x�t j" | � D]�} t j j | | � } t j j | d- � }! t j j | d � }" | |! � }# | |" � }$ t j j# |# � sHt j d. |! � | }# n |# j$ d/ � rd|# d0 }# n t j j |# � } | | | | � s�q�n |# | k r�| |# � n |$ j! d1 � r|$ j d4 d � d2 }$ |$ j d$ d d � }% t | d3 |$ d | d | d | �}& t }' n d4 }% |$ }& t }' | j |# i � } | | d" <|% | d <|& | d <|' | d <|' r�| | |& d | d | d | �} | r�| | d# <q�q�q�W| S(6 ui
.. versionadded:: 2015.8.0
Returns information on worktrees
.. versionchanged:: 2015.8.4
Version 2.7.0 added the ``list`` subcommand to `git-worktree(1)`_ which
provides a lot of additional information. The return data has been
changed to include this information, even for pre-2.7.0 versions of
git. In addition, if a worktree has a detached head, then any tags
which point to the worktree's HEAD will be included in the return data.
.. note::
By default, only worktrees for which the worktree directory is still
present are returned, but this can be changed using the ``all`` and
``stale`` arguments (described below).
cwd
The path to the git checkout
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
all : False
If ``True``, then return all worktrees tracked under
$GIT_DIR/worktrees, including ones for which the gitdir is no longer
present.
stale : False
If ``True``, return *only* worktrees whose gitdir is no longer present.
.. note::
Only one of ``all`` and ``stale`` can be set to ``True``.
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-worktree(1)`: http://git-scm.com/docs/git-worktree
CLI Examples:
.. code-block:: bash
salt myminion git.list_worktrees /path/to/repo
salt myminion git.list_worktrees /path/to/repo all=True
salt myminion git.list_worktrees /path/to/repo stale=True
R u allu, 'all' and 'stale' cannot both be set to Truec
S@ s8 t d d d | g d | d | d | d | �d j � S( u.
Get any tags that point at a
u gitu tagu --points-atR R R R u stdout( R% R� ( R R� R R R ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt _git_tag_points_at*
s
c S@ s) | r | r% | r% t Sn
| r% t St S( us
Common logic to determine whether or not to include the worktree info
in the return data.
( R R
( t is_staleR� t stale( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt _desired5
s c S@ s t j d | � d S( u�
Log errors to the minion log notifying of duplicate worktree paths.
These should not be there, but may show up due to a bug in git 2.7.0.
u� git.worktree: Duplicate worktree path %s. This may be caused by a known issue in git 2.7.0 (see http://permalink.gmane.org/gmane.comp.version-control.git/283998)N( R[ R\ ( R ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt _duplicate_worktree_pathD
s u worktreeu HEADu branchR u 2.7.0u gitu listu --porcelainR R R R u retcodei u Failed to list worktreesu stderru : {0}c S@ s t j d | � d S( u'
Log a warning
u& git.worktree: Untracked line item '%s'N( R[ Rj ( R� ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt _untracked_item`
s u stdoutu
u u
i u detachedu: git.worktree: Unexpected duplicate %s entry '%s', skippingub git.worktree: Incomplete worktree data, missing the following information: %s. Full data below:
%su , u staleu tagsu refs/heads/R@ u
--git-pathu worktreesu% Failed to find worktree location for t exc_info_on_loglevelu .gitu( Worktree admin directory {0} not presentc S@ s� yV t j j j | d � �8 } x* | D]" } t j j j | � j � } Pq% W| SWd QXWn/ t t f k
r� } t j j j | | � n Xd S( uY
Return contents of a single line file with EOF newline stripped
u rN(
R R RW R� R� R� t stripR� R6 t process_read_exception( R R� R� RN Rv ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt
_read_file�
s
u gitdiru� Non-absolute path found in %s. If git 2.7.0 was installed and then downgraded, this was likely caused by a known issue in git 2.7.0. See http://permalink.gmane.org/gmane.comp.version-control.git/283998 for more information.u /.giti����u ref: i����R� N( u worktreeu HEADu branch(% R R
R R R R R R R R R R R R R% RD R� R7 R� t dictR� R[ R\ R/ R. R t isdirR� t replaceRz R| t loggingt DEBUGt
startswitht listdirR} t endswith(( R R� R R R R) R� R� R� R� t tracked_data_pointsRN R t has_native_list_subcommandt outRx R� t individual_worktreeR� t
worktree_dataR� t type_R� t missingt worktree_is_stalet wt_ptrt
tags_foundR� t
worktree_rootRv R� t
worktree_namet admin_dirt gitdir_filet head_filet wt_loct head_reft wt_brancht wt_headt wt_detached( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt list_worktrees� s E
&% "
#
!
u originc
C@ sY | d
k r t | | � } n y% t j j j | | | d t �} Wn% t k
rj }
t |
j � � � n Xd g t
| � } | j d � | j t
| � � | j | � | r� | j | � n t | d | d | d | d | d |
d | d
| �d } i } xQ | j � D]C } y | j d
d � \ } } Wn t k
rFqn X| | | <qW| S( u�
Interface to `git-ls-remote(1)`_. Returns the upstream hash for a remote
reference.
cwd
The path to the git checkout. Optional (and ignored if present) when
``remote`` is set to a URL instead of a remote name.
remote : origin
The name of the remote to query. Can be the name of a git remote
(which exists in the git checkout defined by the ``cwd`` parameter),
or the URL of a remote repository.
.. versionchanged:: 2015.8.0
Argument renamed from ``repository`` to ``remote``
ref
The name of the ref to query. Optional, if not specified, all refs are
returned. Can be a branch or tag name, or the full name of the
reference (for example, to get the hash for a Github pull request number
1234, ``ref`` can be set to ``refs/pull/1234/head``
.. versionchanged:: 2015.8.0
Argument renamed from ``branch`` to ``ref``
.. versionchanged:: 2015.8.4
Defaults to returning all refs instead of master.
opts
Any additional options to add to the command line, in a single string
.. versionadded:: 2015.8.0
git_opts
Any additional options to add to git command itself (not the
``ls-remote`` subcommand), in a single string. This is useful for
passing ``-c`` to run git with temporary changes to the git
configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
identity
Path to a private key to use for ssh URLs
.. warning::
Unless Salt is invoked from the minion using ``salt-call``, the
key(s) must be passphraseless. For greater security with
passphraseless private keys, see the `sshd(8)`_ manpage for
information on securing the keypair from the remote side in the
``authorized_keys`` file.
.. _`sshd(8)`: http://www.man7.org/linux/man-pages/man8/sshd.8.html#AUTHORIZED_KEYS_FILE_FORMAT
.. versionchanged:: 2015.8.7
Salt will no longer attempt to use passphrase-protected keys unless
invoked from the minion using ``salt-call``, to prevent blocking
waiting for user input.
Key can also be specified as a SaltStack file server URL, eg. salt://location/identity_file
.. versionchanged:: 2016.3.0
https_user
Set HTTP Basic Auth username. Only accepted for HTTPS URLs.
.. versionadded:: 2015.5.0
https_pass
Set HTTP Basic Auth password. Only accepted for HTTPS URLs.
.. versionadded:: 2015.5.0
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
saltenv
The default salt environment to pull sls files from
.. versionadded:: 2016.3.1
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-ls-remote(1)`: http://git-scm.com/docs/git-ls-remote
CLI Example:
.. code-block:: bash
salt myminion git.ls_remote /path/to/repo origin master
salt myminion git.ls_remote remote=https://mydomain.tld/repo.git ref=mytag opts='--tags'
R� u gitu ls-remoteR R R Rk R Rl R u stdouti N( R R R R Rg R� R
R� R R� RF R$ R" RC R% R� R7 R? ( R R� t refR@ R� R R Rk R� R� R R Rl Rv R+ R� RN R� t ref_sha1R� ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt ls_remote s> �
c K@ s� t j j j | � } | r1 t j j j | � n t | | � } d g t | � }
|
j d � |
j t | � � | r� |
j | � n t
|
d | d | d | d | d | d | �d S(
u�
Interface to `git-merge(1)`_
cwd
The path to the git checkout
rev
Revision to merge into the current branch. If not specified, the remote
tracking branch will be merged.
.. versionadded:: 2015.8.0
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the ``merge``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
identity
Path to a private key to use for ssh URLs. Salt will not attempt to use
passphrase-protected keys unless invoked from the minion using
``salt-call``, to prevent blocking waiting for user input. Key can also
be specified as a SaltStack file server URL, eg.
``salt://location/identity_file``.
.. note::
For greater security with passphraseless private keys, see the
`sshd(8)`_ manpage for information on securing the keypair from the
remote side in the ``authorized_keys`` file.
.. _`sshd(8)`: http://www.man7.org/linux/man-pages/man8/sshd.8.html#AUTHORIZED_KEYS_FILE_FORMAT
.. versionadded:: 2018.3.5,2019.2.1,Neon
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-merge(1)`: http://git-scm.com/docs/git-merge
CLI Example:
.. code-block:: bash
# Fetch first...
salt myminion git.fetch /path/to/repo
# ... then merge the remote tracking branch
salt myminion git.merge /path/to/repo
# .. or merge another rev
salt myminion git.merge /path/to/repo rev=upstream/foo
u gitu mergeR R R Rk R R u stdout( R R R R R R RF R$ R" RC R% ( R R� R@ R� R R Rk R R R) R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt merge� s a
c K@ sD t | | � } t j j j | � } | j d t � }
| rR t j j j | � n |
ry | sj | sj | ry t d � � n | d! k r� g } nI t
| t t f � s� g t
j | � j d � D] } | j � ^ q� } n t g | | | | f D] } | r� | ^ q� � } | d k r#t d � � nf | rMt | � d k r�t d � � q�n< | r�t | � d k rtt d � � q�| s�d g } q�n | r t t d
t � � t d � k r t | d | d
d d g d | d | d |
d | �} t | d | d t d | d | d |
d | �| k Sn d g t | � } | j d � | j t | � � |
rg| j d � n | r}| j d � nH | r�| j d � n2 | r�| j d � n | r�| j d | g � n | j | � t | d | d | d | d |
d | r�t n t d | �} | r"| d d
k S| d j � } |
r<| S| d
S(" ul
.. versionadded:: 2015.8.0
Interface to `git-merge-base(1)`_.
cwd
The path to the git checkout
refs
Any refs/commits to check for a merge base. Can be passed as a
comma-separated list or a Python list.
all : False
Return a list of all matching merge bases. Not compatible with any of
the below options except for ``octopus``.
octopus : False
If ``True``, then this function will determine the best common
ancestors of all specified commits, in preparation for an n-way merge.
See here_ for a description of how these bases are determined.
Set ``all`` to ``True`` with this option to return all computed merge
bases, otherwise only the "best" will be returned.
is_ancestor : False
If ``True``, then instead of returning the merge base, return a
boolean telling whether or not the first commit is an ancestor of the
second commit.
.. note::
This option requires two commits to be passed.
.. versionchanged:: 2015.8.2
Works properly in git versions older than 1.8.0, where the
``--is-ancestor`` CLI option is not present.
independent : False
If ``True``, this function will return the IDs of the refs/commits
passed which cannot be reached by another commit.
fork_point
If passed, then this function will return the commit where the
commit diverged from the ref specified by ``fork_point``. If no fork
point is found, ``None`` is returned.
.. note::
At most one commit is permitted to be passed if a ``fork_point`` is
specified. If no commits are passed, then ``HEAD`` is assumed.
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
This option should not be necessary unless new CLI arguments are
added to `git-merge-base(1)`_ and are not yet supported in Salt.
git_opts
Any additional options to add to git command itself (not the
``merge-base`` subcommand), in a single string. This is useful for
passing ``-c`` to run git with temporary changes to the git
configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
if ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-merge-base(1)`: http://git-scm.com/docs/git-merge-base
.. _here: http://git-scm.com/docs/git-merge-base#_discussion
CLI Examples:
.. code-block:: bash
salt myminion git.merge_base /path/to/repo HEAD upstream/mybranch
salt myminion git.merge_base /path/to/repo 8f2e542,4ad8cab,cdc9886 octopus=True
salt myminion git.merge_base /path/to/repo refs=8f2e542,4ad8cab,cdc9886 independent=True
salt myminion git.merge_base /path/to/repo refs=8f2e542,4ad8cab is_ancestor=True
salt myminion git.merge_base /path/to/repo fork_point=upstream/master
salt myminion git.merge_base /path/to/repo refs=mybranch fork_point=upstream/master
u alluW The 'all' argument is not compatible with 'independent', 'is_ancestor', or 'fork_point'u ,i uR Only one of 'octopus', 'independent', 'is_ancestor', and 'fork_point' is permittedi u6 Two refs/commits are required if 'is_ancestor' is TrueuA At most one ref/commit can be passed if 'fork_point' is specifiedu HEADR u 1.8.0R� i R@ u --verifyR R R R t refst is_ancestoru gitu
merge-baseu --allu --octopusu
--is-ancestoru
--independentu --fork-pointR R u retcodeu stdoutN( R R R R R R R R R R R R; R� R R! R7 R� t lenR R R| t
merge_baseRF R$ R" RC R% R
R� ( R R
t octopusR t independentt
fork_pointR@ R� R R R R R) R� R� t mutually_exclusive_countt first_commitR+ Ru t all_bases( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyR
( s� | 4. !
c C@ s� t | | � } d d g } | d k r~ y" t | d | | g d | �} Wq~ t t f k
rz t d j | | � � � q~ Xn | j | | | g � t | d | d | d | d | d | �d
S( u�
.. versionadded:: 2015.8.0
Interface to `git-merge-tree(1)`_, shows the merge results and conflicts
from a 3-way merge without touching the index.
cwd
The path to the git checkout
ref1
First ref/commit to compare
ref2
Second ref/commit to compare
base
The base tree to use for the 3-way-merge. If not provided, then
:py:func:`git.merge_base <salt.modules.git.merge_base>` will be invoked
on ``ref1`` and ``ref2`` to determine the merge base to use.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
if ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-merge-tree(1)`: http://git-scm.com/docs/git-merge-tree
CLI Examples:
.. code-block:: bash
salt myminion git.merge_tree /path/to/repo HEAD upstream/dev
salt myminion git.merge_tree /path/to/repo HEAD upstream/dev base=aaf3c3d
u gitu
merge-treeR
R u. Unable to determine merge base for {0} and {1}R R R R u stdoutN( R R R
R R RD R" R% ( R t ref1t ref2t baseR R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt
merge_tree� s" ?
c
C@ sz t | | � } d g t | � } | j d � | j t | � � t | d | d | d | d | d | d | d | �d
S( uA
Interface to `git-pull(1)`_
cwd
The path to the git checkout
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the ``pull``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
identity
Path to a private key to use for ssh URLs
.. warning::
Unless Salt is invoked from the minion using ``salt-call``, the
key(s) must be passphraseless. For greater security with
passphraseless private keys, see the `sshd(8)`_ manpage for
information on securing the keypair from the remote side in the
``authorized_keys`` file.
.. _`sshd(8)`: http://www.man7.org/linux/man-pages/man8/sshd.8.html#AUTHORIZED_KEYS_FILE_FORMAT
.. versionchanged:: 2015.8.7
Salt will no longer attempt to use passphrase-protected keys unless
invoked from the minion using ``salt-call``, to prevent blocking
waiting for user input.
Key can also be specified as a SaltStack file server URL, eg. salt://location/identity_file
.. versionchanged:: 2016.3.0
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
saltenv
The default salt environment to pull sls files from
.. versionadded:: 2016.3.1
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-pull(1)`: http://git-scm.com/docs/git-pull
CLI Example:
.. code-block:: bash
salt myminion git.pull /path/to/repo opts='--rebase origin master'
u gitu pullR R R Rk R Rl R u stdout( R RF R$ R" RC R% (
R R@ R� R R Rk R Rl R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt pullP
s a
c
K@ s� t j j j | � } | r1 t j j j | � n t | | � } d g t | � } | j d � | j t | � � | j | | g � t
| d | d | d | d | d | d | d |
�d
S( u�
Interface to `git-push(1)`_
cwd
The path to the git checkout
remote
Name of the remote to which the ref should being pushed
.. versionadded:: 2015.8.0
ref : master
Name of the ref to push
.. note::
Being a refspec_, this argument can include a colon to define local
and remote ref names.
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the ``push``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
identity
Path to a private key to use for ssh URLs
.. warning::
Unless Salt is invoked from the minion using ``salt-call``, the
key(s) must be passphraseless. For greater security with
passphraseless private keys, see the `sshd(8)`_ manpage for
information on securing the keypair from the remote side in the
``authorized_keys`` file.
.. _`sshd(8)`: http://www.man7.org/linux/man-pages/man8/sshd.8.html#AUTHORIZED_KEYS_FILE_FORMAT
.. versionchanged:: 2015.8.7
Salt will no longer attempt to use passphrase-protected keys unless
invoked from the minion using ``salt-call``, to prevent blocking
waiting for user input.
Key can also be specified as a SaltStack file server URL, eg. salt://location/identity_file
.. versionchanged:: 2016.3.0
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
saltenv
The default salt environment to pull sls files from
.. versionadded:: 2016.3.1
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-push(1)`: http://git-scm.com/docs/git-push
.. _refspec: http://git-scm.com/book/en/v2/Git-Internals-The-Refspec
CLI Example:
.. code-block:: bash
# Push master as origin/master
salt myminion git.push /path/to/repo origin master
# Push issue21 as upstream/develop
salt myminion git.push /path/to/repo upstream issue21:develop
# Delete remote branch 'upstream/temp'
salt myminion git.push /path/to/repo upstream :temp
u gitu pushR R R Rk R Rl R u stdout( R R R R R R RF R$ R" RC R% (
R R� R R@ R� R R Rk R Rl R R) R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt push�
s v
u masterc C@ s� t | | � } t | � } t d � | D� � r@ t d � � n d g t | � } | j d � | j | � t | t j � s� t j
| � } n | j t j j
j | � � t | d | d | d | d | d | �d
S( u#
Interface to `git-rebase(1)`_
cwd
The path to the git checkout
rev : master
The revision to rebase onto the current branch
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the ``rebase``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-rebase(1)`: http://git-scm.com/docs/git-rebase
CLI Example:
.. code-block:: bash
salt myminion git.rebase /path/to/repo master
salt myminion git.rebase /path/to/repo 'origin master'
salt myminion git.rebase /path/to/repo origin/master opts='--onto newbranch'
c s@ s! | ] } | d k r | Vq d S( u -iu
--interactiveN( u -iu
--interactive( ( R� R� ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pys <genexpr>� s u% Interactive rebases are not supportedu gitu rebaseR R R R R u stdout( R RC R� R RF R$ R" R R R R! R R R R< R% ( R R� R@ R� R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt rebaseH s J
c C@ sh t | | � } t | d | d | d | d | d | �} | | k r` t d j | | � � � n | | S( u�
Get the fetch and push URL for a specific remote
cwd
The path to the git checkout
remote : origin
Name of the remote to query
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
redact_auth : True
Set to ``False`` to include the username/password if the remote uses
HTTPS Basic Auth. Otherwise, this information will be redacted.
.. warning::
Setting this to ``False`` will not only reveal any HTTPS Basic Auth
that is configured, but the return data will also be written to the
job cache. When possible, it is recommended to use SSH for
authentication.
.. versionadded:: 2015.5.6
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Examples:
.. code-block:: bash
salt myminion git.remote_get /path/to/repo
salt myminion git.remote_get /path/to/repo upstream
R R t redact_authR R u7 Remote '{0}' not present in git checkout located at {1}( R t remotesR RD ( R R� R R R R R t all_remotes( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt
remote_get� s ? c K@ s� t j j j | � } | j d d � } | rC t j j j | � n d d g }
| re |
j d � n | r{ |
j d � n y, |
j t j j j | | | d t
�� Wn% t k
r� } t | j
� � � n X| r� |
j | � n t |
d | d | d | d
| d |
d | �d
} i } x] t j j j | d � D]C } y | j d d � \ } } Wn t k
rpq8n X| | | <q8W| S( u
.. versionadded:: 2015.8.0
Return the remote refs for the specified URL by running ``git ls-remote``.
url
URL of the remote repository
filter
Optionally provide a ref name to ``git ls-remote``. This can be useful
to make this function run faster on repositories with many
branches/tags.
.. versionadded:: 2019.2.0
heads : False
Restrict output to heads. Can be combined with ``tags``.
tags : False
Restrict output to tags. Can be combined with ``heads``.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
identity
Path to a private key to use for ssh URLs
.. warning::
Unless Salt is invoked from the minion using ``salt-call``, the
key(s) must be passphraseless. For greater security with
passphraseless private keys, see the `sshd(8)`_ manpage for
information on securing the keypair from the remote side in the
``authorized_keys`` file.
.. _`sshd(8)`: http://www.man7.org/linux/man-pages/man8/sshd.8.html#AUTHORIZED_KEYS_FILE_FORMAT
.. versionchanged:: 2015.8.7
Salt will no longer attempt to use passphrase-protected keys unless
invoked from the minion using ``salt-call``, to prevent blocking
waiting for user input.
Key can also be specified as a SaltStack file server URL, eg. salt://location/identity_file
.. versionchanged:: 2016.3.0
https_user
Set HTTP Basic Auth username. Only accepted for HTTPS URLs.
https_pass
Set HTTP Basic Auth password. Only accepted for HTTPS URLs.
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
saltenv
The default salt environment to pull sls files from
.. versionadded:: 2016.3.1
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Example:
.. code-block:: bash
salt myminion git.remote_refs https://github.com/saltstack/salt.git
salt myminion git.remote_refs https://github.com/saltstack/salt.git filter=develop
u filteru gitu ls-remoteu --headsu --tagsR� R R Rk R Rl R u stdoutu
i N( R R R R R R R R$ Rg R� R
R� R R� R% R� R7 ( Rg t headst tagsR R Rk R� R� R R Rl R) t filter_R+ Rv R� RN R� t sha1_hashR� ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt remote_refs� sB d
c
C@ s� | t | d | d | d | �k rt t j d | | � d d d | g } t | d | d | d | d |
d | �n y% t j j j | | | d
t �} Wn% t k
r� }
t
|
j � � � n Xd d d | | g } t | d | d | d | d |
d | �| r�t | t
j � s(t
j | � } n y% t j j j | | | d
t �} Wn( t k
rw}
t
t
j |
� � � n Xd d d d
| | g } t | d | d | d | d |
d | �n t d | d | d | d | d |
d | � S( uh
cwd
The path to the git checkout
url
Remote URL to set
remote : origin
Name of the remote to set
push_url
If unset, the push URL will be identical to the fetch URL.
.. versionadded:: 2015.8.0
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
https_user
Set HTTP Basic Auth username. Only accepted for HTTPS URLs.
.. versionadded:: 2015.5.0
https_pass
Set HTTP Basic Auth password. Only accepted for HTTPS URLs.
.. versionadded:: 2015.5.0
push_https_user
Set HTTP Basic Auth user for ``push_url``. Ignored if ``push_url`` is
unset. Only accepted for HTTPS URLs.
.. versionadded:: 2015.8.0
push_https_pass
Set HTTP Basic Auth password for ``push_url``. Ignored if ``push_url``
is unset. Only accepted for HTTPS URLs.
.. versionadded:: 2015.8.0
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Examples:
.. code-block:: bash
salt myminion git.remote_set /path/to/repo git@github.com:user/repo.git
salt myminion git.remote_set /path/to/repo git@github.com:user/repo.git remote=upstream
salt myminion git.remote_set /path/to/repo https://github.com/user/repo.git remote=upstream push_url=git@github.com:user/repo.git
R R R uX Remote '%s' already exists in git checkout located at %s, removing so it can be re-addedu gitu remoteu rmR R R� u addu set-urlu --pushR� ( R R[ Ri R% R R Rg R� R
R� R R� R R R R! R ( R Rg R� R R R� R� t push_urlt push_https_usert push_https_passR R R+ Rv ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt
remote_setz sb V
c C@ sY t | | � } d d d g } i } t | d | d | d | d | d | �d } x t j j j | d
� D]� } y | j d d � \ }
} Wn t k
r� qk n Xy | j d d � \ } }
Wn t k
r� qk n X|
j d � j
d
� j � }
|
d k r t j
d |
|
| � qk n | r;t j j j | � } n | | j |
i � |
<qk W| S( ul
Get fetch and push URLs for each remote in a git checkout
cwd
The path to the git checkout
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
redact_auth : True
Set to ``False`` to include the username/password for authenticated
remotes in the return data. Otherwise, this information will be
redacted.
.. warning::
Setting this to ``False`` will not only reveal any HTTPS Basic Auth
that is configured, but the return data will also be written to the
job cache. When possible, it is recommended to use SSH for
authentication.
.. versionadded:: 2015.5.6
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Example:
.. code-block:: bash
salt myminion git.remotes /path/to/repo
u gitu remoteu --verboseR R R R R u stdoutu
i u (u )u fetchu pushuA Unknown action '%s' for remote '%s' in git checkout located in %sN( u fetchu push( R R% R R R� R7 R R� t rsplitt lstripR� R� R[ Rj Rg Rh R� ( R R R R R R R+ RN R� t remote_lineR� t remote_infot
remote_urlt action( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyR s8 ;
c C@ st t | | � } d g t | � } | j d � | j t | � � t | d | d | d | d | d | d | �d S(
u�
Interface to `git-reset(1)`_, returns the stdout from the git command
cwd
The path to the git checkout
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the ``reset``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
identity
Path to a private key to use for ssh URLs. Salt will not attempt to use
passphrase-protected keys unless invoked from the minion using
``salt-call``, to prevent blocking waiting for user input. Key can also
be specified as a SaltStack file server URL, eg.
``salt://location/identity_file``.
.. note::
For greater security with passphraseless private keys, see the
`sshd(8)`_ manpage for information on securing the keypair from the
remote side in the ``authorized_keys`` file.
.. _`sshd(8)`: http://www.man7.org/linux/man-pages/man8/sshd.8.html#AUTHORIZED_KEYS_FILE_FORMAT
.. versionadded:: 2018.3.5,2019.2.1,Neon
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-reset(1)`: http://git-scm.com/docs/git-reset
CLI Examples:
.. code-block:: bash
# Soft reset to a specific commit ID
salt myminion git.reset /path/to/repo ac3ee5c
# Hard reset
salt myminion git.reset /path/to/repo opts='--hard origin/master'
u gitu resetR R R Rk R R u stdout( R RF R$ R" RC R% ( R R@ R� R R Rk R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt reset` s W
c C@ s� t | | � } d g t | � } | j d � | j t | � � | d k r^ | j | � n t | d | d | d | d | d | �d S(
u�
.. versionadded:: 2015.8.0
Interface to `git-rev-parse(1)`_
cwd
The path to the git checkout
rev
Revision to parse. See the `SPECIFYING REVISIONS`_ section of the
`git-rev-parse(1)`_ manpage for details on how to format this argument.
This argument is optional when using the options in the `Options for
Files` section of the `git-rev-parse(1)`_ manpage.
opts
Any additional options to add to the command line, in a single string
git_opts
Any additional options to add to git command itself (not the
``rev-parse`` subcommand), in a single string. This is useful for
passing ``-c`` to run git with temporary changes to the git
configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-rev-parse(1)`: http://git-scm.com/docs/git-rev-parse
.. _`SPECIFYING REVISIONS`: http://git-scm.com/docs/git-rev-parse#_specifying_revisions
.. _`Options for Files`: http://git-scm.com/docs/git-rev-parse#_options_for_files
CLI Examples:
.. code-block:: bash
# Get the full SHA1 for HEAD
salt myminion git.rev_parse /path/to/repo HEAD
# Get the short SHA1 for HEAD
salt myminion git.rev_parse /path/to/repo HEAD opts='--short'
# Get the develop branch's upstream tracking branch
salt myminion git.rev_parse /path/to/repo 'develop@{upstream}' opts='--abbrev-ref'
# Get the SHA1 for the commit corresponding to tag v1.2.3
salt myminion git.rev_parse /path/to/repo 'v1.2.3^{commit}'
# Find out whether or not the repo at /path/to/repo is a bare repository
salt myminion git.rev_parse /path/to/repo opts='--is-bare-repository'
u gitu rev-parseR R R R R u stdoutN( R RF R$ R" RC R R% ( R R� R@ R� R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyR| � s R
c C@ sj t | | � } d d g } | r1 | j d � n | j | � t | d | d | d | d | d | �d S(
u�
Returns the SHA1 hash of a given identifier (hash, branch, tag, HEAD, etc.)
cwd
The path to the git checkout
rev : HEAD
The revision
short : False
If ``True``, return an abbreviated SHA1 git hash
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Example:
.. code-block:: bash
salt myminion git.revision /path/to/repo mybranch
u gitu rev-parseu --shortR R R R R u stdout( R R$ R% ( R R� t shortR R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt revision$ s 5
c C@ s� t | | � } d g t | � } | j d � | j t | � � | j d | g � t | d | d | d | d | d | �d S(
u�
Interface to `git-rm(1)`_
cwd
The path to the git checkout
filename
The location of the file/directory to remove, relative to ``cwd``
.. note::
To remove a directory, ``-r`` must be part of the ``opts``
parameter.
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the ``rm``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-rm(1)`: http://git-scm.com/docs/git-rm
CLI Examples:
.. code-block:: bash
salt myminion git.rm /path/to/repo foo/bar.py
salt myminion git.rm /path/to/repo foo/bar.py opts='--dry-run'
salt myminion git.rm /path/to/repo foo/baz opts='-r'
u gitu rmu --R R R R R u stdout( R RF R$ R" RC R% ( R R� R@ R� R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt rm_f s M
u savec C@ st t | | � } d g t | � } | j d | g � | j t | � � t | d | d | d | d | d | �d S( u<
Interface to `git-stash(1)`_, returns the stdout from the git command
cwd
The path to the git checkout
opts
Any additional options to add to the command line, in a single string.
Use this to complete the ``git stash`` command by adding the remaining
arguments (i.e. ``'save <stash comment>'``, ``'apply stash@{2}'``,
``'show'``, etc.). Omitting this argument will simply run ``git
stash``.
git_opts
Any additional options to add to git command itself (not the ``stash``
subcommand), in a single string. This is useful for passing ``-c`` to
run git with temporary changes to the git configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-stash(1)`: http://git-scm.com/docs/git-stash
CLI Examples:
.. code-block:: bash
salt myminion git.stash /path/to/repo save opts='work in progress'
salt myminion git.stash /path/to/repo apply opts='stash@{1}'
salt myminion git.stash /path/to/repo drop opts='stash@{1}'
salt myminion git.stash /path/to/repo list
u gitu stashR R R R R u stdout( R RF R" RC R% ( R R- R@ R� R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt stash� s F c C@ s� t | | � } i d d 6d d 6d d 6d d 6} i } d d
d d g } t | d
| d | d | d | d | �d } xu | j t d � � D]^ } y | j d d � \ }
} Wn t k
r� q� n X| j | j |
|
� g � j | � q� W| S( u�
.. versionchanged:: 2015.8.0
Return data has changed from a list of lists to a dictionary
Returns the changes to the repository
cwd
The path to the git checkout
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Example:
.. code-block:: bash
salt myminion git.status /path/to/repo
u modifiedu Mu newu Au deletedu Du untrackedu ??u gitu statusu -zu --porcelainR R R R R u stdoutu i N( R R% R7 t strR R� R� RV R$ ( R R R R R t state_mapRN R+ R� R� t stateR� ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt status s* 0
)c
K@ s� t j j j |
� }
|
j d t � } |
rC t j j j |
� n t | | � } | rg t d � � n d g t | � } | j
d | g � | j
t | � � t | d | d | d | d | d | d
| d | �d S(
u"
.. versionchanged:: 2015.8.0
Added the ``command`` argument to allow for operations other than
``update`` to be run on submodules, and deprecated the ``init``
argument. To do a submodule update with ``init=True`` moving forward,
use ``command=update opts='--init'``
Interface to `git-submodule(1)`_
cwd
The path to the submodule
command
Submodule command to run, see `git-submodule(1) <git submodule>` for
more information. Any additional arguments after the command (such as
the URL when adding a submodule) must be passed in the ``opts``
parameter.
.. versionadded:: 2015.8.0
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` (as in the CLI examples
below) to avoid causing errors with Salt's own argument parsing.
git_opts
Any additional options to add to git command itself (not the
``submodule`` subcommand), in a single string. This is useful for
passing ``-c`` to run git with temporary changes to the git
configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
init : False
If ``True``, ensures that new submodules are initialized
.. deprecated:: 2015.8.0
Pass ``init`` as the ``command`` parameter, or include ``--init``
in the ``opts`` param with ``command`` set to update.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
identity
Path to a private key to use for ssh URLs
.. warning::
Unless Salt is invoked from the minion using ``salt-call``, the
key(s) must be passphraseless. For greater security with
passphraseless private keys, see the `sshd(8)`_ manpage for
information on securing the keypair from the remote side in the
``authorized_keys`` file.
.. _`sshd(8)`: http://www.man7.org/linux/man-pages/man8/sshd.8.html#AUTHORIZED_KEYS_FILE_FORMAT
.. versionchanged:: 2015.8.7
Salt will no longer attempt to use passphrase-protected keys unless
invoked from the minion using ``salt-call``, to prevent blocking
waiting for user input.
Key can also be specified as a SaltStack file server URL, eg. salt://location/identity_file
.. versionchanged:: 2016.3.0
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
saltenv
The default salt environment to pull sls files from
.. versionadded:: 2016.3.1
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-submodule(1)`: http://git-scm.com/docs/git-submodule
CLI Example:
.. code-block:: bash
# Update submodule and ensure it is initialized (before 2015.8.0)
salt myminion git.submodule /path/to/repo/sub/repo init=True
# Update submodule and ensure it is initialized (2015.8.0 and later)
salt myminion git.submodule /path/to/repo/sub/repo update opts='--init'
# Rebase submodule (2015.8.0 and later)
salt myminion git.submodule /path/to/repo/sub/repo update opts='--rebase'
# Add submodule (2015.8.0 and later)
salt myminion git.submodule /path/to/repo/sub/repo add opts='https://mydomain.tld/repo.git'
# Unregister submodule (2015.8.0 and later)
salt myminion git.submodule /path/to/repo/sub/repo deinit
u initu� The 'init' argument is no longer supported. Either set 'command' to 'init', or include '--init' in the 'opts' argument and set 'command' to 'update'.u gitu submoduleR R R Rk R Rl R u stdout(
R R R R R R R R R RF R" RC R% (
R R+ R@ R� R R Rk R Rl R R) t init_t cmd( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt submoduleZ s& � c
@ s� t | | � } d g t | � } | j d � t � � � | d
k rr t � f d � d D� � rr t d � � n | j � � | j | � | r� | j | � n t | d | d | d | d
| d | �d S( u
.. versionadded:: 2015.8.0
Interface to `git-symbolic-ref(1)`_
cwd
The path to the git checkout
ref
Symbolic ref to read/modify
value
If passed, then the symbolic ref will be set to this value and an empty
string will be returned.
If not passed, then the ref to which ``ref`` points will be returned,
unless ``--delete`` is included in ``opts`` (in which case the symbolic
ref will be deleted).
opts
Any additional options to add to the command line, in a single string
git_opts
Any additional options to add to git command itself (not the
``symbolic-refs`` subcommand), in a single string. This is useful for
passing ``-c`` to run git with temporary changes to the git
configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-symbolic-ref(1)`: http://git-scm.com/docs/git-symbolic-ref
CLI Examples:
.. code-block:: bash
# Get ref to which HEAD is pointing
salt myminion git.symbolic_ref /path/to/repo HEAD
# Set/overwrite symbolic ref 'FOO' to local branch 'foo'
salt myminion git.symbolic_ref /path/to/repo FOO refs/heads/foo
# Delete symbolic ref 'FOO'
salt myminion git.symbolic_ref /path/to/repo FOO opts='--delete'
u gitu symbolic-refc 3@ s | ] } | � k Vq d S( N( ( R� R� ( R@ ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pys <genexpr>O s u -du --deleteuG Value cannot be set for symbolic ref if -d/--delete is included in optsR R R R R u stdoutN( u -du --delete( R RF R$ RC R R� R R" R% (
R R R� R@ R� R R R R R+ ( ( R@ s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt symbolic_ref� s" S
(
c
C@ s� t | | � } d g t | � }
|
j d � g t | � D] } | d k r< | ^ q< } t d � | D� � r t d � � n |
j | � |
j | � d | k r� d | k r� |
j | � n t |
d | d
| d | d | d
t d | �d S( u
.. versionadded:: 2018.3.4
Interface to `git-tag(1)`_, adds and removes tags.
cwd
The path to the main git checkout or a linked worktree
name
Name of the tag
ref : HEAD
Which ref to tag (defaults to local clone's HEAD)
.. note::
This argument is ignored when either ``-d`` or ``--delete`` is
present in the ``opts`` passed to this function.
message
Optional message to include with the tag. If provided, an annotated tag
will be created.
opts
Any additional options to add to the command line, in a single string
.. note::
Additionally, on the Salt CLI, if the opts are preceded with a
dash, it is necessary to precede them with ``opts=`` (as in the CLI
examples below) to avoid causing errors with Salt's own argument
parsing.
git_opts
Any additional options to add to git command itself (not the
``worktree`` subcommand), in a single string. This is useful for
passing ``-c`` to run git with temporary changes to the git
configuration.
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. _`git-tag(1)`: http://git-scm.com/docs/git-tag
CLI Example:
.. code-block:: bash
# Create an non-annotated tag
salt myminion git.tag /path/to/repo v1.2
# Create an annotated tag
salt myminion git.tag /path/to/repo v1.2 message='Version 1.2'
# Delete the tag
salt myminion git.tag /path/to/repo v1.2 opts='-d'
u gitu tagu -au
--annotatec s@ s' | ] } | d k p d | k Vq d S( u -mu --messageN( ( R� R� ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pys <genexpr>� s u5 Tag messages must be passed in the "message" argumentu -du --deleteR R R R RT R u stdout( u -au
--annotate( R RF R$ RC R� R R" R% R
(
R R� R R� R@ R� R R R R R+ R� t formatted_opts( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt tag` s$ U
+
c C@ s1 d } d } | t k r� y t d d g � d } Wn) t k
r] } t j d | � d } n Xy | j � d t | <Wq� t k
r� t j d � d t | <q� Xn | s� t | S| t k r)t j | g � } xV t | j d
� D]> } y | j t | � � Wq� t
k
r!| j | � q� Xq� Wn t | S( u
.. versionadded:: 2015.8.0
Returns the version of Git installed on the minion
versioninfo : False
If ``True``, return the version in a versioninfo list (e.g. ``[2, 5,
0]``)
CLI Example:
.. code-block:: bash
salt myminion git.version
u git.versionu git.versioninfou gitu --versionu stdoutu4 Failed to obtain the git version (error follows):
%su unknowni����u* Running 'git --version' returned no stdoutu .( R{ R% R R[ R\ R7 R? R� R$ t intR� ( R R~ t contextkey_infoRE Rv t ptrt part( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyR � s2
c K@ s~ t � t j j j | � } | j d d � }
| rJ t j j j | � n t | | � } |
rt | rt t d � � n d g t
| � } | j d d g � | r� | r� t j
d � n | j d � nP |
s� t j j | � }
n | j | r� d n d |
g � | r| j d
� n | j t | � � | j | � | rL| j | � n t | d | d | d
| d |
d t d | �d S( u�
.. versionadded:: 2015.8.0
Interface to `git-worktree(1)`_, adds a worktree
cwd
The path to the git checkout
worktree_path
Path to the new worktree. Can be either absolute, or relative to
``cwd``.
branch
Name of new branch to create. If omitted, will be set to the basename
of the ``worktree_path``. For example, if the ``worktree_path`` is
``/foo/bar/baz``, then ``branch`` will be ``baz``.
ref
Name of the ref on which to base the new worktree. If omitted, then
``HEAD`` is use, and a new branch will be created, named for the
basename of the ``worktree_path``. For example, if the
``worktree_path`` is ``/foo/bar/baz`` then a new branch ``baz`` will be
created, and pointed at ``HEAD``.
reset_branch : False
If ``False``, then `git-worktree(1)`_ will fail to create the worktree
if the targeted branch already exists. Set this argument to ``True`` to
reset the targeted branch to point at ``ref``, and checkout the
newly-reset branch into the new worktree.
force : False
By default, `git-worktree(1)`_ will not permit the same branch to be
checked out in more than one worktree. Set this argument to ``True`` to
override this.
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` to avoid causing errors
with Salt's own argument parsing.
All CLI options for adding worktrees as of Git 2.5.0 are already
supported by this function as of Salt 2015.8.0, so using this
argument is unnecessary unless new CLI arguments are added to
`git-worktree(1)`_ and are not yet supported in Salt.
git_opts
Any additional options to add to git command itself (not the
``worktree`` subcommand), in a single string. This is useful for
passing ``-c`` to run git with temporary changes to the git
configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-worktree(1)`: http://git-scm.com/docs/git-worktree
CLI Examples:
.. code-block:: bash
salt myminion git.worktree_add /path/to/repo/main ../hotfix ref=origin/master
salt myminion git.worktree_add /path/to/repo/main ../hotfix branch=hotfix21 ref=v2.1.9.3
u branchu, Only one of 'branch' and 'detach' is allowedu gitu worktreeu addu@ 'force' argument to git.worktree_add is ignored when detach=Trueu --detachu -Bu -bu --forceR R R R RT R u stdoutN( R R R R R R R R R R RF R" R[ Rj R$ R. R R� RC R% R
( R t
worktree_pathR t reset_branchR� t detachR@ R� R R R R R) t branch_R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt worktree_add� s@ m
c
C@ s� t � t | | � } d g t | � }
|
j d d g � | rR |
j d � n | rh |
j d � n | r� |
j d | g � n |
j t | � � t |
d | d | d | d
| d | �d S(
u�
.. versionadded:: 2015.8.0
Interface to `git-worktree(1)`_, prunes stale worktree administrative data
from the gitdir
cwd
The path to the main git checkout or a linked worktree
dry_run : False
If ``True``, then this function will report what would have been
pruned, but no changes will be made.
verbose : True
Report all changes made. Set to ``False`` to suppress this output.
expire
Only prune unused worktree data older than a specific period of time.
The date format for this parameter is described in the documentation
for the ``gc.pruneWorktreesExpire`` config param in the
`git-config(1)`_ manpage.
opts
Any additional options to add to the command line, in a single string
.. note::
On the Salt CLI, if the opts are preceded with a dash, it is
necessary to precede them with ``opts=`` to avoid causing errors
with Salt's own argument parsing.
All CLI options for pruning worktrees as of Git 2.5.0 are already
supported by this function as of Salt 2015.8.0, so using this
argument is unnecessary unless new CLI arguments are added to
`git-worktree(1)`_ and are not yet supported in Salt.
git_opts
Any additional options to add to git command itself (not the
``worktree`` subcommand), in a single string. This is useful for
passing ``-c`` to run git with temporary changes to the git
configuration.
.. versionadded:: 2017.7.0
.. note::
This is only supported in git 1.7.2 and newer.
user
User under which to run the git command. By default, the command is run
by the user under which the minion is running.
password
Windows only. Required when specifying ``user``. This parameter will be
ignored on non-Windows platforms.
.. versionadded:: 2016.3.4
ignore_retcode : False
If ``True``, do not log an error to the minion log if the git command
returns a nonzero exit status.
.. versionadded:: 2015.8.0
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
.. _`git-worktree(1)`: http://git-scm.com/docs/git-worktree
.. _`git-config(1)`: http://git-scm.com/docs/git-config/2.5.1
CLI Examples:
.. code-block:: bash
salt myminion git.worktree_prune /path/to/repo
salt myminion git.worktree_prune /path/to/repo dry_run=True
salt myminion git.worktree_prune /path/to/repo expire=1.day.ago
u gitu worktreeu pruneu --dry-runu --verboseu --expireR R R R R u stdout( R R RF R" R$ RC R% ( R t dry_runt verboset expireR@ R� R R R R R+ ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt worktree_prune� s" _ c C@ s� t � t | | � } t j j | � s; t | d � � n% t | d | �s` t | d � � n y t j j j
| � Wn+ t k
r� } t d j | | � � � n Xt
S( u�
.. versionadded:: 2015.8.0
Recursively removes the worktree located at ``cwd``, returning ``True`` if
successful. This function will attempt to determine if ``cwd`` is actually
a worktree by invoking :py:func:`git.is_worktree
<salt.modules.git.is_worktree>`. If the path does not correspond to a
worktree, then an error will be raised and no action will be taken.
.. warning::
There is no undoing this action. Be **VERY** careful before running
this function.
cwd
Path to the worktree to be removed
user
Used for path expansion when ``cwd`` is not an absolute path. By
default, when ``cwd`` is not absolute, the path will be assumed to be
relative to the home directory of the user under which the minion is
running. Setting this option will change the home directory from which
path expansion is performed.
output_encoding
Use this option to specify which encoding to use to decode the output
from any git commands which are run. This should not be needed in most
cases.
.. note::
This should only be needed if the files in the repository were
created with filenames using an encoding other than UTF-8 to handle
Unicode characters.
.. versionadded:: 2018.3.1
CLI Examples:
.. code-block:: bash
salt myminion git.worktree_rm /path/to/worktree
u does not existR u is not a git worktreeu Unable to remove {0}: {1}( R R R. R R� R R� R R RW t rm_rft ExceptionRD R
( R R R Rv ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt worktree_rm s +(a t __doc__t
__future__R R R R� RI R� R. R� R3 t salt.utils.argsR t salt.utils.datat salt.utils.filest salt.utils.functoolst salt.utils.itertoolst salt.utils.patht salt.utils.platformt salt.utils.stringutilst salt.utils.templatest salt.utils.urlt salt.exceptionsR R t salt.utils.versionsR R t salt.extR t getLoggert __name__R[ t __func_alias__R R
R R R R, R R: RC RF RO R% Rz R� R# R� R� R� R� R� R� R� R� R t functoolst alias_functiont config_get_regexR� R� R� R� R� R� R� R� R� R� R� R R R R
R R R R R R# R' R R. R| R0 R1 R2 R6 R9 R: R< R RE RI RL ( ( ( s4 /usr/lib/python2.7/site-packages/salt/modules/git.pyt <module> s�
+ � U � ^ h � a ^ [ � | 5 > � 6 � t F B 7 � 3 � n � M h � V I � � W ^ Z > T L F � b e 3 � i
Mini Shell