ó j4Vdc @€sdZddlmZddlmZmZddlZddlmZddlm Z ddl m Z m Z m Z ddlmZmZmZmZdd lmZmZdd lmZd d gZe dded d eedd„ƒZdd ed„ZdS(sN Useful non-core functionality, e.g. functions composing multiple operations. iÿÿÿÿ(twith_statement(tgetcwdtsepN(tdatetime(tmkdtemp(t needs_hostt key_filenamest normalize(tlocaltruntsudotput(tenvtoutput(tcdt rsync_projecttupload_projectts-pthrvzc C€s<t|dƒs|f}ndt|ƒ} tg|D]} t| ƒjddƒ^q5ƒ} d} tƒ} | r‡ddj| ƒ} nttj ƒ\}}}d|}d}tj dkrÇd}n:ttj ƒ\}}}d }|| |||||f}| |||g}t |ƒr5d d j|ƒ}ni|rDd ndd 6| | d6|d6|d6|d6}d|}|dkr¡dt ƒjtƒd}n|jdƒdkrÉd||f}nd||f}|rød||||f}nd||||f}tjr,dtj |fGHnt|d|ƒS(sÿ Synchronize a remote directory with the current project directory via rsync. Where ``upload_project()`` makes use of ``scp`` to copy one's entire project every time it is invoked, ``rsync_project()`` uses the ``rsync`` command-line utility, which only transfers files newer than those on the remote end. ``rsync_project()`` is thus a simple wrapper around ``rsync``; for details on how ``rsync`` works, please see its manpage. ``rsync`` must be installed on both your local and remote systems in order for this operation to work correctly. This function makes use of Fabric's ``local()`` operation, and returns the output of that function call; thus it will return the stdout, if any, of the resultant ``rsync`` call. ``rsync_project()`` uses the current Fabric connection parameters (user, host, port) by default, adding them to rsync's ssh options (then mixing in ``ssh_opts``, if given -- see below.) ``rsync_project()`` takes the following parameters: * ``remote_dir``: the only required parameter, this is the path to the directory on the remote server. Due to how ``rsync`` is implemented, the exact behavior depends on the value of ``local_dir``: * If ``local_dir`` ends with a trailing slash, the files will be dropped inside of ``remote_dir``. E.g. ``rsync_project("/home/username/project/", "foldername/")`` will drop the contents of ``foldername`` inside of ``/home/username/project``. * If ``local_dir`` does **not** end with a trailing slash (and this includes the default scenario, when ``local_dir`` is not specified), ``remote_dir`` is effectively the "parent" directory, and a new directory named after ``local_dir`` will be created inside of it. So ``rsync_project("/home/username", "foldername")`` would create a new directory ``/home/username/foldername`` (if needed) and place the files there. * ``local_dir``: by default, ``rsync_project`` uses your current working directory as the source directory. This may be overridden by specifying ``local_dir``, which is a string passed verbatim to ``rsync``, and thus may be a single directory (``"my_directory"``) or multiple directories (``"dir1 dir2"``). See the ``rsync`` documentation for details. * ``exclude``: optional, may be a single string, or an iterable of strings, and is used to pass one or more ``--exclude`` options to ``rsync``. * ``delete``: a boolean controlling whether ``rsync``'s ``--delete`` option is used. If True, instructs ``rsync`` to remove remote files that no longer exist locally. Defaults to False. * ``extra_opts``: an optional, arbitrary string which you may use to pass custom arguments or options to ``rsync``. * ``ssh_opts``: Like ``extra_opts`` but specifically for the SSH options string (rsync's ``--rsh`` flag.) * ``capture``: Sent directly into an inner `~fabric.operations.local` call. * ``upload``: a boolean controlling whether file synchronization is performed up or downstream. Upstream by default. * ``default_opts``: the default rsync options ``-pthrvz``, override if desired (e.g. to remove verbosity, etc). Furthermore, this function transparently honors Fabric's port and SSH key settings. Calling this function when the current host string contains a nonstandard port, or when ``env.key_filename`` is non-empty, will use the specified port and/or SSH key filename(s). For reference, the approximate ``rsync`` command-line call that is constructed by this function is the following:: rsync [--delete] [--exclude exclude[0][, --exclude[1][, ...]]] \ [default_opts] [extra_opts] : .. versionadded:: 1.4.0 The ``ssh_opts`` keyword argument. .. versionadded:: 1.4.1 The ``capture`` keyword argument. .. versionadded:: 1.8.0 The ``default_opts`` keyword argument. t__iter__s --exclude "%s"t"s\\"Rs-i s -i s-p %ss0-A -o "ProxyCommand=ssh %s -p %s %s@%s nc %s %s"s--rsh='ssh %s't s--deletetdeletetexcludetrshtdefaulttextras3%(delete)s%(exclude)s %(default)s %(extra)s %(rsh)ss../iÿÿÿÿt:is[%s@%s]s%s@%ssrsync %s %s %s:%ssrsync %s %s:%s %ss[%s] rsync_project: %stcaptureN(thasattrtlenttupletstrtreplaceRtjoinRR t host_stringtgatewaytNonetanyRtsplitRtcountR trunningR(t remote_dirt local_dirRRt extra_optstssh_optsRtuploadt default_optst exclude_optstst exclusionst key_stringtkeystuserthosttportt port_stringt rsh_stringt gateway_optstgw_usertgw_hosttgw_porttgw_strt rsh_partst options_maptoptionst remote_prefixtcmd((sd/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/contrib/project.pyRsLZ 1         c C€s|r tpt}|p!tjƒ}|jtjƒ}tjj|ƒ\}}d|}tjj||ƒ}t ƒ}zztjj||ƒ} t d| ||fƒt | |d|ƒt |ƒ)z|d|ƒWd|d|ƒXWdQXWdt d|ƒXdS(s Upload the current project to a remote system via ``tar``/``gzip``. ``local_dir`` specifies the local project directory to upload, and defaults to the current working directory. ``remote_dir`` specifies the target directory to upload into (meaning that a copy of ``local_dir`` will appear as a subdirectory of ``remote_dir``) and defaults to the remote user's home directory. ``use_sudo`` specifies which method should be used when executing commands remotely. ``sudo`` will be used if use_sudo is True, otherwise ``run`` will be used. This function makes use of the ``tar`` and ``gzip`` programs/libraries, thus it will not work too well on Win32 systems unless one is using Cygwin or something similar. It will attempt to clean up the local and remote tarfiles when it finishes executing, even in the event of a failure. .. versionchanged:: 1.1 Added the ``local_dir`` and ``remote_dir`` kwargs. .. versionchanged:: 1.7 Added the ``use_sudo`` kwarg. s %s.tar.gzstar -czf %s -C %s %stuse_sudos tar -xzf %sNsrm -f %ss rm -rf %s( R R tosRtrstripRtpathR&R!RRR R( R*R)RCtrunnert local_patht local_namettar_filet target_tart tmp_folderttar_path((sd/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/contrib/project.pyR¥s    ((t__doc__t __future__RRDRRtos.pathRttempfileRtfabric.networkRRRtfabric.operationsRR R R t fabric.stateR R tfabric.context_managersRt__all__R$tFalsetTrueRR(((sd/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/contrib/project.pyts( " ‰