nodebpy 520.17.0__tar.gz → 520.19.0__tar.gz

{nodebpy-520.17.0 → nodebpy-520.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nodebpy
-Version: 520.17.0
+Version: 520.19.0
 Summary: Build nodes trees in Blender more elegantly with code
 Author: Brady Johnston
 Author-email: Brady Johnston <brady.johnston@me.com>
@@ -8,10 +8,12 @@ License: GPL-3.0-or-later
 Requires-Dist: bpy==5.2.* ; extra == 'bpy'
 Requires-Dist: ruff>=0.14.11 ; extra == 'format'
 Requires-Dist: networkx>=3.6.1 ; extra == 'networkx'
+Requires-Dist: matplotlib>=3.8 ; extra == 'plot'
 Requires-Python: >=3.13
 Provides-Extra: bpy
 Provides-Extra: format
 Provides-Extra: networkx
+Provides-Extra: plot
 Description-Content-Type: text/markdown
 
 # nodebpy

{nodebpy-520.17.0 → nodebpy-520.19.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nodebpy"
-version = "520.17.0"
+version = "520.19.0"
 description = "Build nodes trees in Blender more elegantly with code"
 readme = "README.md"
 authors = [
@@ -16,6 +16,9 @@ nodebpy = "nodebpy:main"
 networkx = [
     "networkx>=3.6.1",
 ]
+plot = [
+    "matplotlib>=3.8",
+]
 bpy = [
     "bpy==5.2.*",
 ]
@@ -46,6 +49,7 @@ dev = [
     "griffe<2.0.0",
     "ty==0.0.74",
     "types-networkx>=3.6.1.20260728",
+    "matplotlib>=3.11.2",
 ]
 
 # The bpy stubs mark most collections/pointers as `| None` and cannot type
@@ -67,3 +71,4 @@ ignore = ["SIM117", "RUF059"]
 [tool.ruff.lint.per-file-ignores]
 "tests/test_codegen.py" = ["S102"]
 "tests/test_assets.py" = ["S102"]
+"tests/test_layout_snapshot.py" = ["S102"]

nodebpy-520.19.0/src/nodebpy/__init__.py

@@ -0,0 +1,26 @@
+from . import builder, export, nodes, types
+from .builder import (
+    ArrangeMethod,
+    SimpleOptions,
+    SugiyamaOptions,
+    TreeBuilder,
+    arrange,
+    default_sugiyama_options,
+)
+from .nodes import compositor, geometry, shader
+
+__all__ = [
+    "ArrangeMethod",
+    "SimpleOptions",
+    "SugiyamaOptions",
+    "TreeBuilder",
+    "arrange",
+    "builder",
+    "compositor",
+    "default_sugiyama_options",
+    "export",
+    "geometry",
+    "nodes",
+    "shader",
+    "types",
+]

{nodebpy-520.17.0 → nodebpy-520.19.0}/src/nodebpy/assets/__init__.py

@@ -10,12 +10,14 @@ compositor}.assets`` and are re-exported alongside the built-in nodes.
 ``dump_library`` and ``build_library`` round-trip a ``.blend`` asset library
 through Python source: every asset is dumped to its own ``.py`` file (the
 version-controlled source of truth) and the ``.blend`` is rebuilt from them
-(``python -m nodebpy.assets dump/build``).
+(``python -m nodebpy.assets dump/build``). ``plot_library`` renders node
+groups from a ``.blend`` to PNG images by name or wildcard
+(``python -m nodebpy.assets plot``), for review outside Blender.
 """
 
 from ..builder import AssetLibrary, BundledLibrary, PackageLibrary
 from ._codegen import generate_asset_api, generate_asset_modules
-from ._library import build_library, dump_library
+from ._library import build_library, dump_library, plot_library
 
 __all__ = [
     "AssetLibrary",
@@ -25,4 +27,5 @@ __all__ = [
     "dump_library",
     "generate_asset_api",
     "generate_asset_modules",
+    "plot_library",
 ]

{nodebpy-520.17.0 → nodebpy-520.19.0}/src/nodebpy/assets/__main__.py

@@ -77,9 +77,12 @@ def parse_args() -> argparse.Namespace:  # pragma: no cover - CLI wrapper
             ".blend to per-asset .py source files\n"
             "  build <source-dir> <blend>   rebuild the .blend asset library "
             "from dumped .py source files\n"
+            "  plot <blend> <output-dir> [names ...]\n"
+            "                               render node groups (wildcards "
+            "supported) to PNG images\n"
             "\n"
-            "See 'python -m nodebpy.assets dump --help' and "
-            "'python -m nodebpy.assets build --help' for their options."
+            "See 'python -m nodebpy.assets dump --help', '… build --help' "
+            "and '… plot --help' for their options."
         ),
         formatter_class=argparse.RawDescriptionHelpFormatter,
     )
@@ -124,9 +127,10 @@ def parse_args() -> argparse.Namespace:  # pragma: no cover - CLI wrapper
 
 
 def main() -> None:  # pragma: no cover - CLI wrapper
-    # The dump/build subcommands (blend ↔ .py round-trip) have their own
-    # parser; everything else keeps the original flag-based interface.
-    if len(sys.argv) > 1 and sys.argv[1] in ("dump", "build"):
+    # The dump/build/plot subcommands (blend ↔ .py round-trip, PNG renders)
+    # have their own parser; everything else keeps the original flag-based
+    # interface.
+    if len(sys.argv) > 1 and sys.argv[1] in ("dump", "build", "plot"):
         from ._library import main as library_main
 
         library_main(sys.argv[1:])

{nodebpy-520.17.0 → nodebpy-520.19.0}/src/nodebpy/assets/_codegen.py

@@ -290,7 +290,7 @@ def _introspect(library: AssetLibrary, names: set[str] | None) -> list[_AssetCla
 def _library_source(library: AssetLibrary) -> str:
     """Source expression that reconstructs ``library`` in the generated module."""
     if isinstance(library, BundledLibrary):
-        return f"BundledLibrary({library.filename!r})"
+        return f"BundledLibrary({_fmt(library.filename)})"
     from ..builder import PackageLibrary
 
     if isinstance(library, PackageLibrary):
@@ -298,7 +298,7 @@ def _library_source(library: AssetLibrary) -> str:
         # so the generated module imports cleanly and stays cross-platform even
         # when ``relative`` was passed as a ``Path``.
         relative = Path(library.relative).as_posix()
-        return f"PackageLibrary(__file__, {relative!r})"
+        return f"PackageLibrary(__file__, {_fmt(relative)})"
     raise TypeError(f"Cannot serialise asset library: {library!r}")
 
 
@@ -355,8 +355,8 @@ def _render_class(cls: _AssetClass, docstrings: bool = False) -> str:
     return f"""class {cls.class_name}({base}):
     {docstring}
 
-    _name = {cls.asset_name!r}
-    _asset_name = {cls.asset_name!r}
+    _name = {_fmt(cls.asset_name)}
+    _asset_name = {_fmt(cls.asset_name)}
     _library = {cls.library_source}
 
 {inputs_cls}
@@ -451,7 +451,7 @@ def interface_parts(
     if library_source:
         base = asset_group_base(cls.tree_idname).__name__
         attr_lines = [
-            f"_asset_name = {cls.asset_name!r}",
+            f"_asset_name = {_fmt(cls.asset_name)}",
             f"_library = {library_source}",
         ]