ó j4Vdc@€sºdZddlmZddlZddlmZddlmZddlm Z ddl m Z d „Z d „Z d „Zd „Zd „Zd„Zd„Zdd„Zd„ZdS(s- Convenience decorators for use in fabfiles. iÿÿÿÿ(twith_statementN(twraps(tRandom(ttasksi(tsettingsc€sktˆ p ˆƒ}ˆjdtjƒ‰|sBˆdd}‰n‡‡‡fd†}|ra|S||ƒS(s« Decorator declaring the wrapped function to be a new-style task. May be invoked as a simple, argument-less decorator (i.e. ``@task``) or with arguments customizing its behavior (e.g. ``@task(alias='myalias')``). Please see the :ref:`new-style task ` documentation for details on how to use this decorator. .. versionchanged:: 1.2 Added the ``alias``, ``aliases``, ``task_class`` and ``default`` keyword arguments. See :ref:`task-decorator-arguments` for details. .. versionchanged:: 1.5 Added the ``name`` keyword argument. .. seealso:: `~fabric.docs.unwrap_tasks`, `~fabric.tasks.WrappedCallableTask` t task_classic€sˆ|ˆˆŽS(N((tfunc(targstkwargsR(s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pytwrapper&s((tbooltpopRtWrappedCallableTask(RRtinvokedRR ((RRRs_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyttasks cC€s#t|tjƒrtj|ƒS|S(N(t isinstanceRtTaskR (toriginaltnew((s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyt _wrap_as_new+s c€s‡‡fd†}|S(Nc€s}tˆƒ‡fd†ƒ}ˆ}t|ƒdkrTt|dtƒ rT|d}nt|ˆt|ƒƒtˆ|ƒ}|S(Nc€s ˆ||ŽS(N((RR(R(s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pytinner_decorator3sii(RtlenRt basestringtsetattrtlistR(RRt_values(t attributetvalues(Rs_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyt attach_list2s& ((RRR((RRs_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyt_list_annotating_decorator1s cG€s td|ŒS(s€ Decorator defining which host or hosts to execute the wrapped function on. For example, the following will ensure that, barring an override on the command line, ``my_func`` will be run on ``host1``, ``host2`` and ``host3``, and with specific users on ``host1`` and ``host3``:: @hosts('user1@host1', 'host2', 'user2@host3') def my_func(): pass `~fabric.decorators.hosts` may be invoked with either an argument list (``@hosts('host1')``, ``@hosts('host1', 'host2')``) or a single, iterable argument (``@hosts(['host1', 'host2'])``). Note that this decorator actually just sets the function's ``.hosts`` attribute, which is then read prior to executing the function. .. versionchanged:: 0.9.2 Allow a single, iterable argument (``@hosts(iterable)``) to be used instead of requiring ``@hosts(*iterable)``. thosts(R(t host_list((s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyRBscG€s td|ŒS(sÜ Decorator defining a list of role names, used to look up host lists. A role is simply defined as a key in `env` whose value is a list of one or more host connection strings. For example, the following will ensure that, barring an override on the command line, ``my_func`` will be executed against the hosts listed in the ``webserver`` and ``dbserver`` roles:: env.roledefs.update({ 'webserver': ['www1', 'www2'], 'dbserver': ['db1'] }) @roles('webserver', 'dbserver') def my_func(): pass As with `~fabric.decorators.hosts`, `~fabric.decorators.roles` may be invoked with either an argument list or a single, iterable argument. Similarly, this decorator uses the same mechanism as `~fabric.decorators.hosts` and simply sets ``.roles``. .. versionchanged:: 0.9.2 Allow a single, iterable argument to be used (same as `~fabric.decorators.hosts`). troles(R(t role_list((s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyR \sc€s7tˆƒ‡‡fd†ƒ‰tˆˆƒ‰tˆƒS(s$ Decorator preventing wrapped function from running more than once. By keeping internal state, this decorator allows you to mark a function such that it will only run once per Python interpreter session, which in typical use means "once per invocation of the ``fab`` program". Any function wrapped with this decorator will silently fail to execute the 2nd, 3rd, ..., Nth time it is called, and will return the value of the original run. .. note:: ``runs_once`` does not work with parallel task execution. c€s+tˆdƒs$ˆ||Žˆ_nˆjS(Nt return_value(thasattrR"(RR(t decoratedR(s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyR$ˆs(RRtserial(R((R$Rs_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyt runs_oncezscC€s+t|dtƒst|_nt||ƒS(sl Forces the wrapped function to always run sequentially, never in parallel. This decorator takes precedence over the global value of :ref:`env.parallel `. However, if a task is decorated with both `~fabric.decorators.serial` *and* `~fabric.decorators.parallel`, `~fabric.decorators.parallel` wins. .. versionadded:: 1.3 tparallel(tgetattrtFalsetTrueR%R(R((s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyR%’s  c€s;tˆƒtjk‰‡‡fd†}ˆr7|ˆƒS|S(s3 Forces the wrapped function to run in parallel, instead of sequentially. This decorator takes precedence over the global value of :ref:`env.parallel `. It also takes precedence over `~fabric.decorators.serial` if a task is decorated with both. .. versionadded:: 1.3 c€sOtˆƒ‡fd†ƒ}t|_t|_ˆr9dnˆ|_tˆ|ƒS(Nc€stjƒˆ||ŽS(N(Rtatfork(RR(R(s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pytinner¯s (RR*R'R)R%tNonet pool_sizeR(RR,(tcalled_without_argsR.(Rs_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pytreal_decorator®s   (ttypettypest FunctionType(R.R0((R/R.s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyR'¢s  c€s‡‡fd†}|S(sG Decorator equivalent of ``fabric.context_managers.settings``. Allows you to wrap an entire function as if it was called inside a block with the ``settings`` context manager. This may be useful if you know you want a given setting applied to an entire function body, or wish to retrofit old code without indenting everything. For example, to turn aborts into warnings for an entire task function:: @with_settings(warn_only=True) def foo(): ... .. seealso:: `~fabric.context_managers.settings` .. versionadded:: 1.1 c€s.tˆƒ‡‡‡fd†ƒ}tˆ|ƒS(Nc€s'tˆˆŽˆ||ŽSWdQXdS(N(R(RR(t arg_settingsRt kw_settings(s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyR,Õs(RR(RR,(R4R5(Rs_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pytouterÔs!((R4R5R6((R4R5s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyt with_settingsÂs(t__doc__t __future__RR2t functoolsRtCryptoRtfabricRtcontext_managersRRRRRR R&R%R-R'R7(((s_/var/www/html/phendo-backend/phendo_python/env/lib/python2.7/site-packages/fabric/decorators.pyts