3~h.rddlZddlmZGddejZdZGddej Zy) N) Connectionc"eZdZdZfdZxZS)TaskaS Extends `invoke.tasks.Task` with knowledge of target hosts and similar. As `invoke.tasks.Task` relegates documentation responsibility to its `@task ` expression, so we relegate most details to our version of `@task ` - please see its docs for details. .. versionadded:: 2.1 cR|jdd|_t| |i|y)Nhosts)poprsuper__init__)selfargskwargs __class__s U/var/www/peopleoo.sandbox-dev.co.uk/venv/lib/python3.12/site-packages/fabric/tasks.pyr z Task.__init__s)ZZ.  $)&))__name__ __module__ __qualname____doc__r __classcell__rs@rrrs**rrcX|jdttj|i|S)a Wraps/extends Invoke's `@task ` with extra kwargs. See `the Invoke-level API docs ` for most details; this Fabric-specific implementation adds the following additional keyword arguments: :param hosts: An iterable of host-connection specifiers appropriate for eventually instantiating a `.Connection`. The existence of this argument will trigger automatic parameterization of the task when invoked from the CLI, similar to the behavior of :option:`--hosts`. .. note:: This parameterization is "lower-level" than that driven by :option:`--hosts`: if a task decorated with this parameter is executed in a session where :option:`--hosts` was given, the CLI-driven value will win out. List members may be one of: - A string appropriate for being the first positional argument to `.Connection` - see its docs for details, but these are typically shorthand-only convenience strings like ``hostname.example.com`` or ``user@host:port``. - A dictionary appropriate for use as keyword arguments when instantiating a `.Connection`. Useful for values that don't mesh well with simple strings (e.g. statically defined IPv6 addresses) or to bake in more complex info (eg ``connect_timeout``, ``connect_kwargs`` params like auth info, etc). These two value types *may* be mixed together in the same list, though we recommend that you keep things homogenous when possible, to avoid confusion when debugging. .. note:: No automatic deduplication of values is performed; if you pass in multiple references to the same effective target host, the wrapped task will execute on that host multiple times (including making separate connections). .. versionadded:: 2.1 klass) setdefaultrinvoketask)r rs rrrs)\ gt$ ;; ' ''rc<eZdZdZfdZfdZdZfdZxZS)ConnectionCallzU Subclass of `invoke.tasks.Call` that generates `Connections <.Connection>`. cT|jd}t||i|||_y)aw Creates a new `.ConnectionCall`. Performs minor extensions to `~invoke.tasks.Call` -- see its docstring for most details. Only specific-to-subclass params are documented here. :param dict init_kwargs: Keyword arguments used to create a new `.Connection` when the wrapped task is executed. Default: ``None``. init_kwargsN)r r r r )r r rr rs rr zConnectionCall.__init__Os-jj/  $)&)&rcBt|}|j|d<|S)Nr )r clone_kwargsr )r rrs rr"zConnectionCall.clone_kwargs^s' %' $ 0 0} rc:|j}||d<tdi|S)Nconfig)r r)r r$rs r make_contextzConnectionCall.make_contexths'!!"x#F##rct|}|jr$|dddj|jdz}|S)Nz , host='{}'>host)r __repr__r format)r retrs rr*zConnectionCall.__repr__psDg    cr(^2243C3CF3KLLC r) rrrrr r"r&r*rrs@rrrJs! '$rr)r connectionrrrCallrr%rrr/s1 "*6;;*$/(d*V[[*r