AnyImage/openspec/changes/separate-node-sources-and-tools/specs/developer-tool-cli/spec.md at 9debab5c0ceb60a553f7912a7ce915712913619c

Files

nan 9debab5c0c Add comprehensive tests for image processing nodes and refactor node imports

- Introduced new test files for image layer, image plane, normal scale, object normal rotation, shadeless, and temporary attributes.
- Implemented tests to validate the behavior of alpha curves, depth layers, and normal scales in various rendering engines.
- Refactored import paths for node groups to align with the new directory structure.
- Added checks for temporary attribute lifetimes and ensured proper cleanup without warnings.
- Enhanced CLI commands to require the Blender group and validate the presence of generated node assets before packaging.
- Updated packaging scripts to enforce the existence of necessary assets, preventing build failures.

2026-09-19 21:23:19 +08:00

2.2 KiB

Raw Blame History

MODIFIED Requirements

Requirement: Build and check node groups

node-group build SHALL 使用当前 Python 环境中的 bpy，通过独立 Python 子进程依次构建资产、校验保存的资产、运行 tests/nodes 与 tests/tools/nodes；node-group check SHALL 仅执行后两步。两者 SHALL 支持 --skip-tests 仅跳过节点相关 pytest，且 SHALL 不查找或启动外部 Blender 可执行程序。

Scenario: Build assets

WHEN 用户运行 uv run --group blender node-group build
THEN 使用固定 bpy 环境更新 O_AnyImage.blend，并在独立进程的资产校验和节点相关测试成功后成功退出

Scenario: Check existing assets

WHEN 用户运行 uv run --group blender node-group check
THEN 使用固定 bpy 环境检查已有资产并运行节点相关测试，资产文件内容保持原样

Scenario: Skip Python tests

WHEN build 或 check 指定 --skip-tests
THEN 仍执行独立进程的资产校验，跳过 pytest

Scenario: Stop after failure

WHEN 构建、校验或测试任一步失败
THEN 命令非零退出且不执行后续步骤

Scenario: Missing bpy environment

WHEN 当前 Python 环境无法导入 bpy
THEN 命令非零退出并提示使用 --group blender，不尝试查找外部 Blender

Requirement: Preview node groups

node-group preview SHALL 使用当前 Python 环境中的 bpy，从当前源码在独立 Python 子进程中构建并排列几何节点组，生成 HTML，输出绝对路径并默认打开浏览器，保持资产文件内容原样。默认文件 SHALL 保存于系统临时目录并在命令退出后可供查看。命令 SHALL 支持 --output PATH、--no-open 和 --fragment，不支持选择外部 Blender 可执行程序。

Scenario: Preview current source

WHEN 用户运行 uv run --group blender node-group preview
THEN 生成当前源码的可查看 HTML 并尝试打开浏览器

Scenario: Save without opening

WHEN 用户指定 --output PATH --no-open
THEN HTML 写入指定路径且不启动浏览器

Scenario: Export fragment

WHEN 用户指定 --fragment
THEN 输出 HTML 片段及其路径，不自动打开浏览器

2.2 KiB Raw Blame History Unescape Escape