Welcome to Invoke’s documentation!

This site covers Invoke’s conceptual & API documentation. For basic info on what Invoke is, including its public changelog & how the project is maintained, please see the main project website.

Warning

While fully usable, Invoke is still pre-1.0 software and has no backwards compatibility guarantees until the 1.0 release occurs! Please make sure to read the changelog carefully anytime you upgrade!

Getting started

Many core ideas & API calls are explained in the tutorial/getting-started document:

• Getting started
  • Defining and running task functions
  • Task parameters
  • Listing tasks
  • Running shell commands
  • Declaring pre-tasks
  • Creating namespaces

Concepts

Dig deeper into specific topics:

• Command-line parsing
  • Invocation basics
  • Background
• Configuration
  • Introduction
  • The configuration hierarchy
  • Default configuration values
  • Configuration files
  • Environment variables
  • Collection-based configuration
  • Example of real-world config use
• Task execution
  • Base case
  • Pre- and post-tasks
  • Task deduplication
• Using Invoke as a library
  • Reusing Invoke’s CLI module as a distinct binary
  • Customizing the configuration system’s defaults
• Loading collections
  • Task module discovery
  • Additional load options
• Constructing namespaces
  • Starting out
  • Naming your tasks
  • Nesting collections
  • Importing modules as collections
  • Default tasks
  • Mix and match
  • More shortcuts
• Testing Invoke-using codebases
  • Subclass & modify Invoke ‘internals’
  • Use MockContext
  • Expect Results
  • Avoid mocking dependency code paths altogether
• Automatically responding to program output
  • Background
  • Basic use

The invoke CLI tool

Details on the CLI interface to Invoke, available core flags, and tab completion options.

• Command-line interface
  • inv[oke] command-line program
  • Shell tab completion

API

Know what you’re looking for & just need API details? View our auto-generated API documentation:

• __init__
• collection
• config
• context
• exceptions
• executor
• loader
• parser
• platform
• program
• runners
• tasks
• util
• watchers