Gecko [ klinikpearlcity.com ]

Name	Size	Permission	Date
completion	[ DIR ]	drwxr-xr-x	2026-05-04 18:19
parser	[ DIR ]	drwxr-xr-x	2026-05-04 18:19
vendor	[ DIR ]	drwxr-xr-x	2026-05-04 18:19
__init__.py	2.18 KB	-rw-r--r--	2026-03-24 06:27
__main__.py	47 B	-rw-r--r--	2026-03-24 06:27
_version.py	80 B	-rw-r--r--	2026-03-24 06:27
collection.py	22.52 KB	-rw-r--r--	2026-03-24 06:27
config.py	48.49 KB	-rw-r--r--	2026-03-24 06:27
context.py	24.89 KB	-rw-r--r--	2026-03-24 06:27
env.py	4.29 KB	-rw-r--r--	2026-03-24 06:27
exceptions.py	11.94 KB	-rw-r--r--	2026-03-24 06:27
executor.py	8.65 KB	-rw-r--r--	2026-03-24 06:27
loader.py	5.86 KB	-rw-r--r--	2026-03-24 06:27
main.py	235 B	-rw-r--r--	2026-03-24 06:27
program.py	37.28 KB	-rw-r--r--	2026-03-24 06:27
py.typed	0 B	-rw-r--r--	2026-03-24 06:27
runners.py	63.97 KB	-rw-r--r--	2026-03-24 06:27
tasks.py	19.48 KB	-rw-r--r--	2026-03-24 06:27
terminals.py	7.96 KB	-rw-r--r--	2026-03-24 06:27
util.py	9.78 KB	-rw-r--r--	2026-03-24 06:27
watchers.py	4.98 KB	-rw-r--r--	2026-03-24 06:27

Rename

from typing import Any, Optional

from ._version import __version_info__, __version__  # noqa
from .collection import Collection  # noqa
from .config import Config  # noqa
from .context import Context, MockContext  # noqa
from .exceptions import (  # noqa
    AmbiguousEnvVar,
    AuthFailure,
    CollectionNotFound,
    Exit,
    ParseError,
    PlatformError,
    ResponseNotAccepted,
    SubprocessPipeError,
    ThreadException,
    UncastableEnvVar,
    UnexpectedExit,
    UnknownFileType,
    UnpicklableConfigMember,
    WatcherError,
    CommandTimedOut,
)
from .executor import Executor  # noqa
from .loader import FilesystemLoader  # noqa
from .parser import Argument, Parser, ParserContext, ParseResult  # noqa
from .program import Program  # noqa
from .runners import Runner, Local, Failure, Result, Promise  # noqa
from .tasks import task, call, Call, Task  # noqa
from .terminals import pty_size  # noqa
from .watchers import FailingResponder, Responder, StreamWatcher  # noqa

def run(command: str, **kwargs: Any) -> Optional[Result]:
    """
    Run ``command`` in a subprocess and return a `.Result` object.

See `.Runner.run` for API details.

.. note::
        This function is a convenience wrapper around Invoke's `.Context` and
        `.Runner` APIs.

Specifically, it creates an anonymous `.Context` instance and calls its
        `~.Context.run` method, which in turn defaults to using a `.Local`
        runner subclass for command execution.

.. versionadded:: 1.0
    """
    return Context().run(command, **kwargs)

def sudo(command: str, **kwargs: Any) -> Optional[Result]:
    """
    Run ``command`` in a ``sudo`` subprocess and return a `.Result` object.

See `.Context.sudo` for API details, such as the ``password`` kwarg.

.. note::
        This function is a convenience wrapper around Invoke's `.Context` and
        `.Runner` APIs.

Specifically, it creates an anonymous `.Context` instance and calls its
        `~.Context.sudo` method, which in turn defaults to using a `.Local`
        runner subclass for command execution (plus sudo-related bits &
        pieces).

.. versionadded:: 1.4
    """
    return Context().sudo(command, **kwargs)