Configurando construtores

Descubra construtores por ponto de entrada

Adicionado na versão 1.6.

As extensões de construtores podem ser descobertas por meio de pontos de entrada de modo que não tenham que ser listadas no valor de configuração extensions.

Builder extensions should define an entry point in the "sphinx.builders" group. The name of the entry point needs to match your builder’s name attribute, which is the name passed to the sphinx-build -b option. The entry point value should equal the dotted name of the extension module. Here is an example of how an entry point for ‘mybuilder’ can be defined in the extension’s pyproject.toml

[project.entry-points."sphinx.builders"]
mybuilder = "my.extension.module"

Observe que ainda é necessário registrar o construtor usando add_builder() na função setup() da extensão.