Testing
Always run the test suite locally before opening a PR, and add test cases for any new feature or fix.
Always run the test suite locally before opening a PR, and add test cases for any new feature or fix.
Running the Test Suite
With the project synced (uv sync):
uv run pytest
With Coverage
Use the Pytest: With Coverage VS Code task, or run pytest with the coverage flags against the addon package:
uv run pytest --cov=src/addons/character_dna --cov-report=html:reports/coverage/htmlOpen reports/coverage/html/index.html to review coverage.
Note
New features require accompanying unit tests to be approved. Keep tests close to the behavior they cover and prefer testing through public entry points.
Documentation
Write and preview Fumadocs documentation with version-aware links, shared media components, and agent-readable content.
FAQ
If your issue isn't covered here, search the GitHub issues. Most likely, someone has hit it before. If not, open a new one with your Blender version, addon version, and any console output.