Blender^® Extra Tools Add-on

Blender Add-on with extra tools and features.

Getting Started

Installation

Download the latest version and install in Blender by clicking on menu Edit > Preferences > Add-ons tab > click Install... button and select the downloaded zip file.

Usage

In 3D View / Object Mode:

• Select objects then Object > Make Links > Link materials directly to the object
• Object > Rename all Mesh Data to match linked Object name

Development

Add-on source scripts are located in the blender_extra_tools package.

Prerequisites

Install fake-bpy-module-2.92 to remove Python errors about missing bpy module.

pip install -r requirements.txt

Debugging

Use VS Code and Blender Development extension to install and debug the Add-on in Blender.

Set the extension Workspace setting Blender › Addon: Load Directory to the Add-on blender_extra_tools package directory:

"blender.addon.loadDirectory": "blender_extra_tools",

Running the tests

Test scripts are located in the separate sibling tests package.

• To run all the tests which do not require Blender API (files matching test*.py) execute the following command from the repository root:

  python -m unittest -v
  

• To run all the tests which use Blender API (files matching bl_test*.py) in Blender execute the following command from the repository root:

  blender -b -P scripts/run_bl_tests_in_blender.py
  

  or using Docker containers, e.g.

  docker run -it --rm --workdir /work -v <path to repository root>:/work nytimes/blender:2.92-cpu-ubuntu18.04 blender -b -P scripts/run_bl_tests_in_blender.py
  

• To run tests from a single Blender test script file (file matching bl_test*.py) in Blender which has the Add-on installed already execute the following command from the repository root:

  blender -b -P tests/bl_test_<test suite>.py
  

  Alternatively, to run tests from within VS Code first start debuggable Blender instance by executing Blender: Start command, open the test file and then execute Blender: Run Script command.

Documentation

See this wiki page on how to generate and publish documentation on GitHub Pages.

Built With

• VSCode / Blender Development
• fake-bpy-module-2.92
• flake8
• sphinx
• sphinx-material
• rd-blender-docker
• act - Run your GitHub Actions locally 🚀
• Git Release - A GitHub Action for creating a GitHub Release with Assets and Changelog

License

GPL-3.0 License