Skip to content

examples/showcase: about 520 ungated use_nodes = True assignments (deprecated on 5.x, removed in 6.0), including the bmesh-gear anatomy (#327 incomplete) #471

Description

@TMHSDigital

Why it matters

#327 gated use_nodes = True on < (5, 0, 0) in the skill and snippets, because it is deprecated on 5.x and scheduled for removal in 6.0. The examples and showcase still teach it ungated, about 520 times, including the anatomy every new example copies. Agents read examples as ground truth, and when 6.0 removes the property, every one of these scripts raises.

Evidence

  • About 520 ungated assignments in 133 files: 199 lines in 57 example scripts and 321 lines across all 76 showcase pieces.
  • This includes examples/bmesh-gear/bmesh_gear.py:122,247,437, the reference anatomy in CLAUDE.md.
  • The skill (skills/procedural-materials-and-shaders/SKILL.md:30,154) and both snippets gate it.
  • Live on Blender 5.2.1 LTS:
    • Material.use_nodes and World.use_nodes both report is_deprecated=True.
    • Setting either emits 'Material.use_nodes' is expected to be removed in Blender 6.0.
    • materials.new().node_tree already exists without setting it.

Suggested approach

Codemod every assignment to if bpy.app.version < (5, 0, 0): mat.use_nodes = True, or to a shared one-liner in each helper block (keep check_helper_drift.py happy). Add a rule to tests/check_example_rules.py that rejects an ungated .use_nodes = True in examples, showcase and templates. Consider a matching .mdc rule so user code gets the same advice.

Done when

A repo scan finds 0 ungated assignments, the lint enforces it, and smoke stays green on 5.2 and 4.5.

No activity

Activity on this issue will appear here.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    content-integrityValidation that shipped content matches realityexamplesRunnable smoke-gated examples under examples/priority: mediumImportant, not urgentshowcaseBudget-conformance props under showcase/

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions