peeler 0.1.5

A tool to use a `pyproject.toml` instead of a `blender_manifest.toml` to build Blender add-ons

Peeler

A tool to use a pyproject.toml file instead (or alongside) of the blender_manifest.toml required for building blender add-ons since Blender 4.2 .

To install run:

pip install peeler

Features

Manifest

Create a blender_manifest.toml from fields in a pyproject.toml

• Make sure to have a pyproject.toml with basic field values:

# pyproject.toml

[project]
name = "My Awesome Addon"
version = "1.0.0"

• Some meta-data are specific to Blender, such as blender_version_min, you can specify theses in your pyproject.toml file under the [tool.peeler.manifest] table, here's a minimal pyproject.toml working version:

# pyproject.toml

[project]
name = "My Awesome Addon"
version = "1.0.0"

[tool.peeler.manifest]
blender_version_min = "4.2.0"
id = "my_awesome_addon"
license = ["SPDX:0BSD"]
maintainer = "John Smith"
tagline = "My Add-on is awesome"

• Run peeler to create (or update) blender_manifest.toml:

peeler manifest /path/to/your/pyproject.toml /path/to/blender_manifest.toml

# created blender_manifest.toml

version = "1.0.0"
name = "My Awesome Addon"
schema_version = "1.0.0"
type = "add-on"
blender_version_min = "4.2.0"
id = "my_awesome_addon"
license = ["SPDX:0BSD"]
maintainer = "John Smith"
tagline = "My Add-on is awesome"

The manifest is filled with values from the pyproject [project], [tool.peeler.manifest] tables and default values.

To get a full list of values required or optional in a blender_manifest.toml visit https://docs.blender.org/manual/en/latest/advanced/extensions/getting_started.html#manifest

Authors

• Maxime Letellier - Initial work