pyinvoke/invoke
Invoke
Invoke is a Python task automation library used to define and run named Python functions as command-line tasks. It provides a system for mapping functions to executable commands, enabling the automation of repetitive development workflows and the orchestration of build pipelines.
The project implements a namespace-based task hierarchy, allowing related tasks to be grouped into nested collections for a structured command-line interface. It utilizes a layered configuration resolution system to merge settings from environment variables, configuration files, and defaults.
The toolset includes shell process management capabilities for executing external subprocesses and capturing their output. It further supports command-line usability through shell tab completion and provides mock contexts to simulate execution environments for verifying task logic.
Features
- CLI Tooling - Provides a framework for creating structured command line interfaces to manage project lifecycle and automation.
- Hierarchical Task Nesting - Supports parent-child relationships for organizing related tasks into a navigable command-line hierarchy.
- Named Task Orchestration - Groups executable code into named tasks that are triggered by name via the command line.
- Task Automation Tools - Automates repetitive development workflows by defining and running named Python functions as command-line tasks.
- Task Registration Decorators - Uses function decorators to register Python methods as executable command-line tasks with defined parameters.
- Task Hierarchy Namespacing - Groups executable functions into nested collections to create a structured command line interface with hierarchical naming.
- Command-Line Interface Mappings - Maps command-line arguments and options to executable Python functions.
- Shell and Scripting - Executes shell commands and manages system processes from within Python code.
- Build Pipeline Orchestration - Organizes a sequence of executable tasks to manage build, test, and deployment steps.
- Mock Execution Contexts - Provides mock contexts to simulate execution environments for verifying task logic without running real shell processes.
- Environment Configurations - Manages task settings through configuration files and environment variables across different execution contexts.
- Subprocess Management - Provides utilities for spawning and controlling external system processes from within Python code.
- Configuration Cascade Resolutions - Merges settings from environment variables, configuration files, and defaults into a single unified state.
- Process Lifecycle Wrapping - Wraps subprocess calls to capture output and manage the lifecycle of external system commands.
- Configuration Hierarchy Loading - Loads operational settings from a prioritized sequence of CLI arguments, environment variables, and configuration files.
- Process Output Captures - Executes shell commands and captures stdout, stderr, and exit codes for programmatic workflow automation.
- Build And Packaging - Task management and command execution for Python projects.
- Build Tools - Manages shell-oriented tasks and CLI-invokable code.
- CLI Utilities - Manages shell-oriented sub-processes and tasks.
