This repository is a toolbox to create a new blender addon. To used-it, clone this repository and rename the folder blender_addon_folder with your addon name. It's important to change some files :

Update the file "tests/main.py", line 29, set your addon name.

# Prepare Blender and Unreal dependency
generate_archive(archives, 'blender_addon_folder')

You can remove the folder "presets" and disable the workflow (.gitea/workflows/pr_main.yml, line 38 and 53)

⚠️ It's more easy to use the "_" with your addon folder name, the "-" character can be problematic with python use.

Features

All features covered with this Blender Addon template are :

Generate addon release (.zip archive)
Generate preset release (.zip archive)
Update addon version (bl info) with tag name
Execute unit test with Gitea Action (check if the addon can be installed with blender)
Configuration with Pycharm to test locally
Linter config

Unit Test

All unit tests call docker image stilobique/blender. It's a simple ubuntu image with blender compile. If you want change the blender version tested, edit the main.py inside the tests folder ; change the tag version with your requested tag.

class Container(enum.Enum):
    """Enumerate about the Geometry node"""
    BLENDER = ContainerObject(name='Blender', image='stilobique/blender', tag='3.1.2')

Find the repository git on my public space.

Addons/Plugins dependency

Update json file tests/dependency.json with name, archive and repository Github path. Each entry require archive name, the repository url path '{owner}/{repo}' and optional parameter if the release needed to be a prerelease.