タスクランナーInvokeを使ってみよう

Invoke について

invoke は予め登録しているタスクを実行することができるタスクランナーです。

CLIアプリケーションでのオプション解析、サブコマンドの実行、タスクの編成（前処理/後処理、順次実行)といったことが簡単にできるように設計されています。

invoke のインストール

invoke は拡張モジュールなのでインストールする必要があります。

code: pip

$ pip install invoke

使用方法

invoke につづけてタスクを与えます。タスクは複数続けることができ、それぞれのタスクはパラメタを複数持つことができます。

invoke を短くした inv も使うことができます。

code: zsh

code: tasks.py

from invoke import task

@task

def hello(c):

"""hello world."""

print("Hello, world!")

これについては後述していますので、今は難しく考えずに、こういう決まり事という理解でかまいません。

code: zsh

% invoke -l

Available tasks:

hello hello world.

code:mytasks.py

from invoke import task

@task

def greeting(c):

"""hello world."""

print("Hello, world!")

code: zsh

% invoke -c mytasks -l

Available tasks:

greeting hello world.

% invoke --collection mytasks -l

Available tasks:

greeting hello world.

ヘルプメッセージ

特定のタスクのヘルプメッセージを表示するためには、次のようにコマンドを実行します。

code: zsh

% invoke --help hello

Docstring:

hello world.

Options:

none

% invoke hello --help

Docstring:

hello world.

Options:

none

パラメタ

こうしたタスクの呼び出しは、次のように単純にタスク名を与えて実行するだけです。

code: zsh

% invoke hello

Hello, world!

code: python

from invoke import task

@task

def hello(c, name):

"""hello world."""

print(f"Hello, {name}!")

code: zsh

% invoke --help hello

Docstring:

hello world.

Options:

-n STRING, --name=STRING

パラメタには次のような与え方ができます。

code: zsh

% invoke hello --name=Jack

Hello, Jack!

% invoke hello --name Jack

Hello, Jack!

% invoke hello -n=Jack

Hello, Jack!

% invoke hello -n Jack

Hello, Jack!

% invoke task2 -nJack

Hello, Jack!

タイプ

タスクとして登録した関数のデフォルト値を持つ引数は、invoke がタイプヒントを利用して型を変換して与えます。例えば、次のタスクがあるとします。

code: python

from invoke import task

@task()

def task1(c, count=1):

print(f'Your input number is {count}.　{type(count)}')

@task()

def task2(c, name=None):

print(f'Hello {name}.　{type(name)}')

@task()

def task3(c, flag=False):

print(f'Flag is {flag}.')

@task()

def task4(c, flag=True):

print(f'Flag is {flag}.')

@task()

def task5(c, q=False, v=False):

print(f'q: {q} v: {v}.')

code: zsh

% invoke task1 --count=5

Your input number is 5. <class 'int'>

% invoke --help task1

Docstring:

none

Options:

-c INT, --count=INT

関数 task2 では、デフォルト値がNoneであり、この場合デフォルト値を与えていないときと同じで、

code: zsh

% invoke task2 --name=Jack

Hello Jack. <class 'str'>

% invoke --help task2

Docstring:

none

Options:

-n STRING, --name=STRING

code: zsh

% invoke task3

Flag is False.

% invoke task3 --flag

Flag is True.

% invoke task3 --no-flag

No idea what '--no-flag' is!

code: zsh

% invoke task3 --help

Docstring:

none

Options:

-f, --flag

code: zsh

% invoke task4

Flag is True.

% invoke task4 --flag

Flag is True.

% invoke task4 --no-flag

Flag is False.

code: zsh

% invoke task4 --help

Docstring:

none

Options:

code: zsh

% invoke --help task5

Docstring:

none

Options:

-q

-v

このようなショートオプションの場合は、次のようなパラメタの与え方ができます。

code: zsh

% invoke task5 -qv

q: True v: True.

% invoke task5 -q -v

q: True v: True.

複数の値をとるパラメタ

ひとつのパラメタがリストのように複数の値をもたせたいときがあります。

code: python

from invoke import task

def mytask(c, my_list):

print(my_list)

code: zsh

% invoke mytask -m=1 -m 2 --my-list 3

code: zsh

% invoke --help mytask

Docstring:

none

Options:

-m, --my-list

同じオプションが指示された回数を知りたい

code: python

from invoke import task

def mytask(c, verbose=0):

print(verbose)

code: zsh

% invoke mytask --verbose

1

% invoke mytask -v

1

% invoke mytask -vvv

3

既知のバグ：この場合、ヘルプメッセージにはオプションには、数値を与えることができるように表示されますが、実際にはうまく処理してくれません。

code: zsh

% invoke --help mytask

Docstring:

none

Options:

-v INT, --verbose=INT

タスクの編成

次の例をみてみましょう。

code: python

from invoke import task

@task()

def clean(c):

print("Cleaning")

@task

def publish(c):

print("Publishing")

@task()

def build(c):

print("Building")

code: zsh

% invoke -l

Available tasks:

build

clean

publish

invoke はコマンドラインに記述した順序で、タスクを実行します。

code: zsh

% invoke clean build publish

Cleaning

Building

Publishing

単純な場合ではよいのですが、タスク数が多くなった場合では面倒になります。

invoke では、タスクを登録するときにタスクを編成して、前処理/後処理、順次処理などを実行させることができます。

code: python

from invoke import task

@task()

def clean(c):

print("Cleaning")

@task

def publish(c):

print("Publishing")

def build(c):

print("Building")

code:zsh

% invoke build

Cleaning

Building

Publishing

code: python

from invoke import task

@task

def clean(c):

print("Cleaning")

@task

def distclean(c):

print("Dist Cleaning")

@task(clean, distclean)

def build(c):

print("Building")

code: zsh

% invoke build

Cleaning

Dist Cleaning

Building

タスクは次のように連続して呼び出すこともできます。

code: python

from invoke import task

@task

def clean_obj(c):

print("Cleaning Object files")

@task

def clean_tgz(c):

print("Cleaning .tar.gz files")

@task(clean_obj, clean_tgz)

def clean(c):

print("Cleaned everything")

@task

def makedirs(c):

print("Making directories")

@task(clean, makedirs)

def build(c):

print("Building")

@task(build)

def deploy(c):

print("Deploying")

code: zsh

% invoke -l

Available tasks:

build

clean

clean-obj

clean-tgz

deploy

makedirs

% invoke deploy

Cleaning Object files

Cleaning .tar.gz files

Cleaned everything

Making directories

Building

Deploying

前処理/後処理のタスクにパラメタを与えたい

code: python

from invoke import task, call

@task

def clean(c, which=None):

which = which or 'pyc'

print(f"Cleaning {which}")

@task(call(clean, 'all'))

def first_build(c):

print("Fist Building")

def build(c):

print("Building")

code: zsh

% invoke -l

Available tasks:

build

clean

first-build

% invoke first-build

Cleaning all

Fist Building

% invoke build

Building

Cleaning all

タスクの重複排除

デフォルトでは、事前/事後タスクに含まれているようなタスクは、セッション中に複数回実行されずに、重複排除(Deduplication)されて1回だけ実行されます。

code: zsh

% invoke build

Cleaning

Building

% invoke package

Cleaning

Building

Packaging

% invoke build package

Cleaning

Building

Packaging

タスクが同じ引数で呼び出される場合は重複排除されますが、引数が異なる呼び出しでは重複排除されません。

code: zsh

% invoke --no-dedupe build package

Cleaning

Building

Cleaning

Building

Packaging

既存コードとの連携

既存コードをタスクとして利用したいときがあり、なるべく変更したくない場合があります。

code:hello.py

def hello(name="World"):

return f"Hello {name}!"

このモジュール利用してをCLIアプリケーションとしたい場合は、次のようにラッパー関数を記述すると、既存コードを修正する必要はありません。

code:tasks.py

from hello import hello

from invoke import task

@task(name='hello')

def _hello(c, name):

"""Say hello to someone."""

print(hello(name))

これにより既存コードのラッパーした関数を同じ名前のタスクとすることができます。

code: zsh

% invoke -l

Available tasks:

hello Say Hello to someone.

タスクとして hello があることがわかるので、実行してみましょう。

code: zsh

% invoke hello

Hello World!

% invoke hello Jack

Hello Jack!

プログラムからinvoke を利用する

これまでの例では、 invoke コマンドを利用してコマンドラインからタスクを実行していました。

まず、プロジェクトディレクトリを作成してみましょう。

code: zsh

% mkdir myapp

% cd myapp

% mkdir myapp

code: myapp/app.py

from invoke import Program

__VERSION__='0.1.0'

app = Program(version=__VERSION__)

if __name__ == '__main__':

app.run()

code: zsh

% python myapp/app.py --help

Core options:

--complete Print tab-completion candidates for given

parse remainder.

--hide=STRING Set default value of run()'s 'hide' kwarg.

--no-dedupe Disable task deduplication.

--print-completion-script=STRING Print the tab-completion script for your

preferred shell (bash|zsh|fish).

--prompt-for-sudo-password Prompt user at start of session for the

sudo.password config value.

--write-pyc Enable creation of .pyc files.

-c STRING, --collection=STRING Specify collection name to load.

-d, --debug Enable debug output.

-D INT, --list-depth=INT When listing tasks, only show the first

INT levels.

-e, --echo Echo executed commands before running.

-f STRING, --config=STRING Runtime configuration file to use.

-F STRING, --list-format=STRING Change the display format used when

listing tasks. Should be one of: flat

(default), nested, json.

to a namespace.

-p, --pty Use a pty when executing shell commands.

-r STRING, --search-root=STRING Change root directory used for finding

task modules.

-R, --dry Echo commands instead of running.

-T INT, --command-timeout=INT Specify a global command execution

timeout, in seconds.

-V, --version Show version and exit.

-w, --warn-only Warn, instead of failing, when shell

commands fail.

サブコマンドを登録

code: myapp/tasks.py

from invoke import task

@task()

def hello(c, name="World"):

print(f'Hello {name}.')

code: zsh

% cd myapp

% python app.py -l

Available tasks:

hello

% python app.py hello

Hello World.

コマンドのインストール

ここで、このスクリプトをパッケージとしてインストールしてみましょう。

code: zsh

% mv myapp/app.py myapp/__init__.py

code: setup.pu

from setuptools import setup, find_packages

from myapp import __VERSION__

with open("README.md", "r", encoding="utf-8") as fh:

long_description = fh.read()

setup(

name="myapp",

version=__VERSION__,

author="Example Author",

author_email="author@example.com",

description="A small sample application",

long_description=long_description,

long_description_content_type="text/markdown",

url="",

packages=find_packages(),

python_requires='>=3.6',

entry_points={

"console_scripts": [

"myapp=myapp:app.run",

]

},

)

コマンドをインストール

code: zsh

% python3 -m pip install --upgrade .

ユーザ領域にインストールされます。

code: zsh

% python -m pip install　--editable .

code: zsh

% myapp --version

Myapp 0.1.0

タスクを登録する

ひとつのタスクモジュールを読み込む場合は、基本的なケースでは問題なく機能します。

しかし、タスクをネストされた名前空間のツリーに分割するなどでは、別の方法が必要になります。

code: myapp/__init__.py

from invoke import Program, Collection, task

__VERSION__='0.1.0'

@task

def greeting(c, name="World"):

print(f'Hello {name}')

ns = Collection()

ns.add_task(greeting)

app = Program(version=__VERSION__, namespace=ns)

if __name__ == '__main__':

app.run()

code: zsh

% myapp -l

Subcommands:

greeting

タスクが多くなってきたり、名前空間がネストするような場合では、ファイルを分割する方が柔軟性が高くなります。

そこで、次のようなファイル構成にしてみます。

code: myapp/tasks.py

from invoke import Collection, task

@task

def greeting_message(c, name="World"):

print(f'Hello {name}')

ns = Collection()

ns.add_task(greeting_message, name='greeting')

code: myapp/__init__.py

from invoke import Program

from .tasks import ns

__VERSION__='0.1.0'

app = Program(version=__VERSION__, namespace=ns)

if __name__ == '__main__':

app.run()

タスクをネストさせる

タスクが多くなってきたりすると、機能ごとにファイルを分割したくなります。

code: drinks_tasks.py

from invoke import Collection, task

@task(default=True)

def beer_lover(c):

print("I love Beer")

@task

def wine_lover(c):

print("I love Wine")

@task

def sake_lover(c):

print("I love Sake")

drinks_ns = Collection('drinks')

drinks_ns.add_task(beer_lover, 'beer')

drinks_ns.add_task(wine_lover, 'wine')

drinks_ns.add_task(sake_lover, 'sake')

これを前述の myapp に組み込んでみます。

code: myapp/__init__.py

from invoke import Program

from .tasks import ns

from .drinks_tasks import drinks_ns

__VERSION__='0.1.0'

ns.add_collection(math_ns)

app = Program(version=__VERSION__, namespace=ns)

if __name__ == '__main__':

app.run()

code: zsh

% myapp -l

Subcommands:

greeting

drinks.beer (drinks)

drinks.sake

drinks.wine

% myapp greeting --help

Docstring:

none

Options:

-n STRING, --name=STRING

% myapp greeting

Hello World

% myapp greeting --name=Jack

Hello Jack

% myapp drinks

I love Beer

% myapp drinks.wine

I love Wine

タスクをモジュールとして読み込み

code: myapp/tasks.py

from invoke import task

@task

def greeting_message(c, name="World"):

print(f'Hello {name}')

code:myapp/drinks.py

from invoke import task

@task(default=True)

def beer_lover(c):

print("I love Beer")

@task

def wine_lover(c):

print("I love Wine")

@task

def sake_lover(c):

print("I love Sake")

code: myapp/__init__py

from invoke import Program, Collection

import myapp.tasks, myapp.drinks

__VERSION__='0.1.0'

ns = Collection()

# ns.add_collection(Collection.from_module(tasks))

ns.add_collection(tasks)

# ns.add_collection(Collection.from_module(drinks))

ns.add_collection(drinks)

app = Program(version=__VERSION__, namespace=ns)

if __name__ == '__main__':

app.run()

code: zsh

% myapp -l

Subcommands:

drinks.beer-lover (drinks)

drinks.sake-lover

drinks.wine-lover

tasks.greeting

tasks.run

実はもっと簡単にすることもできます。

code: myapp/__init__.py

from invoke import Program, Collection

import myapp.tasks, myapp.drinks

__VERSION__='0.1.0'

ns = Collection(tasks, drinks)

app = Program(version=__VERSION__, namespace=ns)

if __name__ == '__main__':

app.run()

コンテキスト

code: python

from invoke import task

@task

def hello(c, name="World"):

print(f'Hello {name}')

代表的なものについて説明しています。

run()

code: python

@task()

def cmd_executor(c, cmd=""):

result = c.run(cmd, hide=True, warn=True)

if result.ok:

else:

sudo()

prefix()

ほとんどの場合、シェル環境変数をエクスポートまたは変更するものなど、シェルの状態を変更するシェルスクリプトと一緒にこれを使用することをお勧めします。

最も一般的な使用法の1つは、virtualenvwrapperからのworkonコマンドを使用することです。

code: python

with c.prefix('workon myvenv'):

c.run('./manage.py migrate')

このコードはシェルのコマンドラインで次のように実行することと同じです。

code: bash

$ workon myvenv && ./manage.py migrate

また、特定の環境変数を設定してコマンドを実行したいようなときにも使用することができます。

例えば、構成設定ツール Anasible で実行時のカラー表示をさせたくないときは、

次のようにすることができます。

code: python

from invoke import task

_cmd_base = "ansible-playbook -i hosts/staging -K "

@task

def build_openmpi(c):

with c.prefix('export ANSIBLE_NOCOLOR=1'):

cmd = _cmd_base + "build_openmpi.yaml"

c.run(cmd)

ただし、このようなタスクが多数あるのであれば、Python 標準ライブラリのsubprocess モジュールを使用する方がスッキリ記述できます。

code: python

from invoke import task

import subprocess

myenv = dict(os.environ, ANSIBLE_NOCOLOR="1")

@task

def build_openmpi(c):

cmd = _cmd_base + "build-openmpi.yml"

subprocess.call( cmd.split(), env=myenv)

cwd()

cd()

code: python

# c.run("cd /var/www && ls") と同じ

with c.cd('/var/www/html'):

c.run('ls')

MockContext

これにより、テストを簡単に行うことができます。

たとえば、次のタスクを実行があるとします。

code: python

from invoke import task

@task

def show_platform(c):

uname = c.run("uname -s").stdout.strip()

if uname == 'Darwin':

print("You paid the Apple tax!")

elif uname == 'Linux':

print("Year of Linux on the desktop!")

このタスクをテストするためのタスクは次のようになります。

code: python

import sys

from spec import trap

from invoke import MockContext, Result

from mytasks import show_platform

@trap

def test_show_platform_on_mac():

c = MockContext(run=Result("Darwin\n"))

show_platform(c)

assert "Apple" in sys.stdout.getvalue()

@trap

def test_show_platform_on_linux():

c = MockContext(run=Result("Linux\n"))

show_platform(c)

assert "desktop" in sys

テストの結果判定に必要なものが標準出力のみという場合では、

code: mytasks.py

from invoke import task

@task

def show_platform(c):

print(platform_response(c.run("uname -s")))

def platform_response(result):

uname = result.stdout.strip()

if uname == 'Darwin':

return "You paid the Apple tax!"

elif uname == 'Linux':

return "Year of Linux on the desktop!"

code: python

from invoke import Result

from mytasks import platform_response

def test_platform_response_on_mac():

assert "Apple" in platform_response(Result("Darwin\n"))

def test_platform_response_on_linux():

assert "desktop" in platform_response(Result("Linux\n"))

タスクに自動応答させる

コマンドを実行するとき、応答を求められる場合があります。

いま、例示のために次のシェルスクリプトを用意します。

code: AreYouReady.sh

case ${ans} in

n|N) ;;

y|Y|*) echo "OK. bye-bye." ;;

esac

これに自動応答させるタスクは次のようになります。

code: python

from invoke import task, Responder, CommandTimedOut

@task

def always_ready(c):

responder = Responder(

response="y\n",

)

try:

except CommandTimedOut:

pass

リモートホストでタスクを実行する

invoke はログインしているノードでタスクを実行するものです。場合よっては他ノードで実行させたいときがあります。そうした場合は、関連プロジェクトの Fabric2 を使うと便利です。

Fabric2 は invoke を SSHライブラリを使用するようにラッパーした拡張モジュールです。

Fabric は拡張モジュールなのでインストールする必要があります。

code: pip

$ pip install fabric2

Invoke と Fabric2の違い

Invoke と Fabric2 の最大の違いは、対象ホストがリモートかローカルかではなくて、SSHを経由してタスクを実行するかどうでかです。

ローカルノードであってもSSHを経由してタスクを実行することもありえます。

SSHを経由しない場合では、基本的にはタスクのすべての処理を invoke で完結させることができます。

code:pyton

from invoke import task

@task

def do_something(c):

with c.cd("/path/to/somewhere"):

c.run("ls")

code:python

from fabric.connection import Connection

connection = Connection("username@remote_host")

print(connection.run("ls"))

Fabric2 から Invoke のタスクを利用する

不思議なことにドキュメントには明示されていないのですが、

code: python

from fabric2 import Connection

from invoke import Collection, task

@task()

def greeting_message(c, name="World"):

print(f'Hello {name}')

@task()

def cmd_executor(c, cmd=""):

result = c.run(cmd, hide=True, warn=True)

if result.ok:

else:

@task

def remote_task(c, cmd=""):

con = Connection("webapp@web")

print(cmd_executor(con, cmd))

ns = Collection()

ns.add_task(greeting_message, name='greeting')

ns.add_task(cmd_executor, name='run')

ns.add_task(remote_task, name='remote')

構成ファイル

Invokeでは、構成ファイル、環境変数、タスク名前空間、およびコマンドラインのオプションを通して Inovkeのコアな動作、およびタスク動作を構成することができます。

構成の階層構造

構成が読み込まれる順序は次の通りです。

構成により制御可能な動作の内部デフォルト値。

Collection.configureを介してタスクモジュールで定義されたコレクション駆動型構成。

サブコレクションの構成は最上位のコレクションにマージされ、最終結果が全体的な構成設定となります。

ルートコレクションは実行時にロードされるため、このレベルで定義されている場合、ロード処理自体を変更する構成設定は有効になりません。

ユーザーレベルの構成ファイル。（例：`~/.invoke.yaml)

デフォルトの構成値

Invoke で使用できる構成値には次のものがあります。

構成ファイル

構成ファイルの読み込み

構成ファイルのフォーマット

Invokeでは構成ファイルで任意のネストが可能です。

code: YAML

debug: true

run:

echo: true

code: json

{

"debug": true,

"run": {

"echo": true

}

}

code: python

debug = True

run = {

"echo": True

}

環境変数で設定

環境変数とは、OSがプロセスを起動する際に、親プロセスから子プロセスへ 引き渡される文字列で設定する変数です。環境変数には、値をネストする簡単な方法がなく、また実行するシェルで呼び出されるすべてのコマンドで共有されるため、少し違った設定方法となります。

基本的なルール

型のキャスト

環境変数は既存の構成値をオーバーライドするためだけに使用することができます。

構成値が文字列またはUnicodeオブジェクトの場合、キャストは行われずに環境変数で設定した値がそのままセットされます。

インタプリタと環境によっては、これは、デフォルトで非Unicode文字列型（例：Python 2のstrなど）に設定された変数の値がUnicode文字列に置き換えられてしまう可能性があります。キャストが行われないことで、非Unicode文字列の値が置き換わることを防ぐための、意図的な仕様です。

ブール値は次のように設定されます：

リストとタプルは現在サポートされていないため、例外が発生します。

ネストと下線付きの名前

構成値はPythonレベルまたは構成ファイルで宣言された設定を変更するためだけに使用できるため、構成の現在の状態を調べて判断してくれます。

それでも、両方の解釈が可能な場合がまだあります。

この場合は、invoke は推測を拒否してエラーが発生します。代わりに、構成レイアウトを変更するか、構成設定に環境変数を使用しないようにしてください。

コレクションベースの構成

code: python

from invoke import Collection, task

# このタスクとコレクションは、どこかの別のモジュールから簡単に取得でる

@task

def mytask(ctx):

inner = Collection('inner', mytask)

inner.configure({'conflicted': 'default value'})

# プロジェクトのルート名前空間

ns = Collection(inner)

ns.configure({'conflicted': 'override value'})

code: bash

$ inv inner.mytask

override value

構成ファイルの例

まず、値をハードコーディングした現実的でないタスクからはじめて、さまざまな構成メカニズムを使用するようにしてゆきましょう。

例えば、Sphinxドキュメントをビルドするためのタスクモジュールは次のようになるかもしれません。

code: python

from invoke import task

@task

def clean(ctx):

ctx.run("rm -rf docs/_build")

@task

def build(ctx):

ctx.run("sphinx-build docs docs/_build")

code: python

from invoke import task

target = "docs/_build"

@task

def clean(ctx):

ctx.run("rm -rf {0}".format(target))

@task

def build(ctx):

ctx.run("sphinx-build docs {0}".format(target))

これを実行時にパラメタで与えられるようにしてみます。

code: python

from invoke import task

default_target = "docs/_build"

@task

def clean(ctx, target=default_target):

ctx.run("rm -rf {0}".format(target))

@task

def build(ctx, target=default_target):

ctx.run("sphinx-build docs {0}".format(target))

このタスクモジュールは対象がひとつだけで機能しますが、再利用をするために、このモジュールを別のデフォルトターゲットで使用できるようにしたい場合は、コンテキストを使用して構成を設定するようにします。

コンテキストへの切り替え

構成設定とAPIの取得により、ハードコードされたデフォルト値を、ユーザーが自由に再定義できるように簡単に変更することできます。

code: python

from invoke import Collection, task

default_target = "docs/_build"

@task

def clean(ctx, target=default_target):

ctx.run("rm -rf {0}".format(target))

@task

def build(ctx, target=default_target):

ctx.run("sphinx-build docs {0}".format(target))

ns = Collection(clean, build)

code: python

@task

def clean(ctx, target=None):

ctx.run("rm -rf {0}".format(target or ctx.sphinx.target))

@task

def build(ctx, target=None):

ctx.run("sphinx-build docs {0}".format(

target or ctx.sphinx.target))

ns = Collection(clean, build)

ns.configure({'sphinx': {'target': "docs/_build"}})

構成のオーバーライド

ユーザーがさまざまな方法でデフォルト値をオーバーライドすることができます。

code: python

from invoke import Collection, task

from myproject import docs

@task

def mylocaltask(ctx):

# 何かを行うローカルタスク

pass

# ローカルのルート名前空間にdocsを追加し、さらに独自のタスクを追加

ns = Collection(mylocaltask, docs)

こうしておくと、最後に次の行を追加するだけです。

code: python

ns.configure({'sphinx': {'target': "built_docs"}})

code: invoke.yaml

sphinx:

target: built_docs

参考