nodebpy 520.24.0__tar.gz → 520.26.0__tar.gz

{nodebpy-520.24.0 → nodebpy-520.26.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nodebpy
-Version: 520.24.0
+Version: 520.26.0
 Summary: Build nodes trees in Blender more elegantly with code
 Author: Brady Johnston
 Author-email: Brady Johnston <brady.johnston@me.com>

{nodebpy-520.24.0 → nodebpy-520.26.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nodebpy"
-version = "520.24.0"
+version = "520.26.0"
 description = "Build nodes trees in Blender more elegantly with code"
 readme = "README.md"
 authors = [

{nodebpy-520.24.0 → nodebpy-520.26.0}/src/nodebpy/assets/_library.py

@@ -1275,24 +1275,33 @@ def plot_library(
     *,
     dpi: int = 150,
     arrange: SugiyamaOptions | None = None,
+    tree: bool = True,
+    node: bool = True,
+    open_panels: bool = False,
 ) -> dict[str, Path]:
     """Render node groups from ``blend_path`` to PNG images under
-    ``output_dir`` — a headless look at node graphs, e.g. for posting in
-    pull requests (``python -m nodebpy.assets plot``).
+    ``output_dir`` — a headless, Blender-styled look at node graphs, e.g.
+    for reviewing new nodes in pull requests (``python -m nodebpy.assets
+    plot``).
 
     ``names`` selects the groups to plot: exact names or :mod:`fnmatch`
     wildcard patterns (``"Style *"``), matched against *every* node group in
     the ``.blend`` (not just assets); ``None`` plots them all. A pattern
-    matching nothing raises. Each tree is drawn with
-    :func:`nodebpy.export.to_plot` (which needs the optional ``matplotlib``
-    dependency) at its stored layout, or re-arranged first when ``arrange``
-    options are given. Everything appended for plotting is removed from the
-    session again afterwards.
+    matching nothing raises. Each group is rendered twice: its internals
+    (``<name>.png``, :func:`nodebpy.export.to_plot`, drawn at the stored
+    layout or re-arranged first when ``arrange`` options are given) and the
+    single group node a user sees when adding it (``<name>_node.png``,
+    ``to_plot(node=True)``, with every interface panel expanded when
+    ``open_panels`` is set); ``tree=False`` / ``node=False`` skip either.
+    Both need the optional ``matplotlib`` dependency.
+    Everything appended for plotting is removed from the session again
+    afterwards.
 
     Returns
     -------
     dict[str, Path]
-        Mapping of group name to the image it was written to.
+        Mapping of group name (suffixed with ``" (node)"`` for the group-node
+        render) to the image it was written to.
     """
     blend_path = Path(blend_path)
     output_dir = Path(output_dir)
@@ -1339,12 +1348,23 @@ def plot_library(
     try:
         output_dir.mkdir(parents=True, exist_ok=True)
         written: dict[str, Path] = {}
-        for tree in dst.node_groups:
-            assert tree is not None
-            if arrange is not None:
-                arrange_tree_nodes(tree, arrange)
-            slug = re.sub(r"[^A-Za-z0-9._-]+", "_", tree.name).lstrip(".") or "tree"
-            written[tree.name] = to_plot(tree, output_dir / f"{slug}.png", dpi=dpi)
+        for group in dst.node_groups:
+            assert group is not None
+            if arrange is not None and tree:
+                arrange_tree_nodes(group, arrange)
+            slug = re.sub(r"[^A-Za-z0-9._-]+", "_", group.name).lstrip(".") or "tree"
+            if tree:
+                written[group.name] = to_plot(
+                    group, output_dir / f"{slug}.png", title=group.name, dpi=dpi
+                )
+            if node:
+                written[f"{group.name} (node)"] = to_plot(
+                    group,
+                    output_dir / f"{slug}_node.png",
+                    dpi=dpi,
+                    node=True,
+                    open_panels=open_panels,
+                )
     finally:
         for coll in _CLEANUP_COLLECTIONS:
             data = getattr(bpy.data, coll)
@@ -1386,7 +1406,7 @@ def _add_arrangement_flags(parser, description: str) -> None:  # pragma: no cove
         choices=["LEFT_DOWN", "RIGHT_DOWN", "LEFT_UP", "RIGHT_UP", "BALANCED"],
         help=(
             "Direction of layout — which corner nodes align towards, or "
-            "'balanced' to even out the four extremes (default: right_up)."
+            "'balanced' to even out the four extremes (default: balanced)."
         ),
     )
     layout.add_argument(
@@ -1422,6 +1442,38 @@ def _add_arrangement_flags(parser, description: str) -> None:  # pragma: no cove
         action="store_true",
         help="Fit the widths of collapsed nodes to their display name.",
     )
+    layout.add_argument(
+        "--no-sequential-frames",
+        dest="sequential_frames",
+        action="store_false",
+        help=(
+            "Do not rank frames as stages of the flow (by default every node "
+            "of a frame comes after every node of the frame feeding it, so "
+            "frames line up left to right instead of stacking)."
+        ),
+    )
+    layout.add_argument(
+        "--no-balance-heights",
+        dest="balance_heights",
+        action="store_false",
+        help=(
+            "Do not promote feeder chains into emptier columns to shorten the "
+            "tallest column."
+        ),
+    )
+    layout.add_argument(
+        "--balance-aspect",
+        type=float,
+        help=("Width-to-height ratio the height balancing aims for (default: 1.6)."),
+    )
+    layout.add_argument(
+        "--reroute-margin-y-fac",
+        type=float,
+        help=(
+            "Fraction of the vertical spacing kept between consecutive "
+            "reroutes in a column (default: 0.35)."
+        ),
+    )
 
 
 def _arrange_options_from_args(args) -> SugiyamaOptions | None:
@@ -1446,6 +1498,14 @@ def _arrange_options_from_args(args) -> SugiyamaOptions | None:
         overrides["stack_margin_y_fac"] = args.stack_margin_y_fac
     if args.optimize_sizes:
         overrides["optimize_sizes"] = True
+    if not args.sequential_frames:
+        overrides["sequential_frames"] = False
+    if not args.balance_heights:
+        overrides["balance_heights"] = False
+    if args.balance_aspect is not None:
+        overrides["balance_aspect"] = args.balance_aspect
+    if args.reroute_margin_y_fac is not None:
+        overrides["reroute_margin_y_fac"] = args.reroute_margin_y_fac
     return SugiyamaOptions(**overrides) if overrides else None
 
 
@@ -1726,13 +1786,15 @@ def _parse_args(argv: list[str] | None = None):
         "plot",
         help="Render node groups from a .blend to PNG images.",
         description=(
-            "Render node groups from a .blend to PNG images — a headless "
-            "look at node graphs, e.g. for posting in pull requests. Selects "
-            "groups by exact name or fnmatch wildcard ('Style *'), matched "
-            "against every node group in the file (not just assets); with no "
-            "names, every group is plotted. Trees are drawn at their stored "
-            "layout unless --arrange (or any arrangement flag) is given. "
-            "Requires matplotlib (pip install nodebpy[plot])."
+            "Render node groups from a .blend to PNG images — a headless, "
+            "Blender-styled look at node graphs, e.g. for reviewing new nodes "
+            "in pull requests. Selects groups by exact name or fnmatch "
+            "wildcard ('Style *'), matched against every node group in the "
+            "file (not just assets); with no names, every group is plotted. "
+            "Each group gets two images: its internals (<name>.png, drawn at "
+            "the stored layout unless --arrange or any arrangement flag is "
+            "given) and the group node as seen from another tree "
+            "(<name>_node.png). Requires matplotlib (pip install nodebpy[plot])."
         ),
     )
     plot.add_argument("blend", type=Path, help="The .blend holding the node groups.")
@@ -1746,6 +1808,24 @@ def _parse_args(argv: list[str] | None = None):
         ),
     )
     plot.add_argument("--dpi", type=int, default=150, help="Image DPI (default: 150).")
+    plot.add_argument(
+        "--tree-only",
+        action="store_true",
+        help="Only render the internals of each group (skip <name>_node.png).",
+    )
+    plot.add_argument(
+        "--node-only",
+        action="store_true",
+        help="Only render each group as a group node (skip <name>.png).",
+    )
+    plot.add_argument(
+        "--open-panels",
+        action="store_true",
+        help=(
+            "Expand every interface panel in the group-node render instead "
+            "of drawing panels in their default closed state."
+        ),
+    )
     plot.add_argument(
         "--arrange",
         action="store_true",
@@ -1835,10 +1915,13 @@ def main(argv: list[str] | None = None) -> None:  # pragma: no cover - CLI wrapp
             args.names or None,
             dpi=args.dpi,
             arrange=method,
+            tree=not args.node_only,
+            node=not args.tree_only,
+            open_panels=args.open_panels,
         )
         for name, path in written.items():
             print(f"  {name}: {path}")
-        print(f"Plotted {len(written)} node groups to {args.output}")
+        print(f"Wrote {len(written)} images to {args.output}")
     else:
         _build_command(args)
 

{nodebpy-520.24.0 → nodebpy-520.26.0}/src/nodebpy/assets/_pipeline.py

@@ -97,6 +97,10 @@ _CONFIG_KEYS: dict[str, tuple[str | None, str]] = {
     "no-stack-collapsed": ("stack_collapsed", "off"),
     "stack-margin-y-fac": ("stack_margin_y_fac", "value"),
     "optimize-sizes": ("optimize_sizes", "flag"),
+    "no-sequential-frames": ("sequential_frames", "off"),
+    "no-balance-heights": ("balance_heights", "off"),
+    "balance-aspect": ("balance_aspect", "value"),
+    "reroute-margin-y-fac": ("reroute_margin_y_fac", "value"),
 }
 
 # Which dest each positional config key fills, per subcommand: the dump
@@ -132,6 +136,10 @@ _OPTION_DEFAULTS: dict[str, object] = {
     "stack_collapsed": True,
     "stack_margin_y_fac": None,
     "optimize_sizes": False,
+    "sequential_frames": True,
+    "balance_heights": True,
+    "balance_aspect": None,
+    "reroute_margin_y_fac": None,
 }
 
 # The resolved options the stamp fingerprint covers: everything, beyond the
@@ -140,6 +148,8 @@ _OPTION_DEFAULTS: dict[str, object] = {
 # it gates the session check, not the output.
 _STAMP_DESTS = (
     "add_reroutes",
+    "balance_aspect",
+    "balance_heights",
     "compress",
     "direction",
     "iterations",
@@ -149,6 +159,8 @@ _STAMP_DESTS = (
     "nodebpy_pkg",
     "on_missing",
     "optimize_sizes",
+    "reroute_margin_y_fac",
+    "sequential_frames",
     "snapshot_positions",
     "socket_alignment",
     "spacing",