$ show pyinvoke/invoke
Invoke is a Python library and command-line tool for task execution and automation. It enables users to define Python functions as tasks that can run shell commands, manage dependencies via pre/post tasks, and be organized into hierarchical namespaces. The system is commonly used for build automation, deployment, and general scripting, featuring a layered configuration system, sophisticated argument parsing, and automated subprocess interaction via responders. The architecture centers around a task system (@task decorator and Collection objects), a configuration manager with layered merging (defaults, files, environment, runtime, code), and an executor that handles task invocation and command execution. Key components include the Config class for configuration management, the Parser/ParserContext for CLI argument handling, and the Responder/FailingResponder classes for automating responses to subprocess prompts (e.g., sudo passwords). The design emphasizes modularity, with clear separation between task definition, configuration, execution, and CLI interfacing. Invoke demonstrates strong engineering practices through its vendored dependencies (fluidity, lexicon, PyYAML) to ensure stability, comprehensive test suite, and support for modern Python versions (3.9+). The codebase avoids tight coupling in core utilities like configuration and argument parsing, making them suitable for extraction. Recent activity (commit within 30 days) indicates active maintenance, and the project shows low technical drift with up-to-date dependency management and no evident deprecated patterns.
The LLM identified 3 files worth highlighting for reuse:
The invoke.config module provides a layered configuration system that merges settings from multiple sources (defaults, files, environment, runtime, code-level overrides). It features a DataProxy class for nested attribute/dict access and customizable merging behavior (e.g., for lists). This component is loosely coupled (depending mainly on invoke.util and invoke.exceptions) and could be extracted for use in other projects requiring flexible configuration management.
The invoke.parser module implements a sophisticated command-line argument parser supporting inverse flags (--no-foo), iterable arguments, and remainder arguments (to pass unparsed arguments to underlying commands). It separates core parser options from task-specific options and allows dynamic task-based argument handling. This self-contained module demonstrates non-obvious skill in handling complex CLI scenarios and could be reused in other CLI applications.
The invoke.watchers module provides Responder and FailingResponder classes for automating responses to subprocess prompts (e.g., sudo passwords). It uses a flexible pattern-matching system (strings, regexes, or callables) to detect prompts and send appropriate responses. This pattern is isolated from the rest of the system (depending only on invoke.util, invoke.exceptions, and standard library) and could be extracted for use in any project needing to interact with interactive subprocesses.