node_to_json 0.1.1__tar.gz

node_to_json-0.1.1/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: node_to_json
+Version: 0.1.1
+Summary: Blender 5.2 Serialize Node Groups to JSON files.Load Node Groups from JSON files.
+Author: Demingo Hill (Noizirom) (C)
+License-Expression: GPL-3.0-only
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# Node To JSON
+
+## Convert Blender 5.2 Nodes to JSON files. Convert JSON objects to Blender Nodes.
+### Created to work with Blender Addons and Extensions to serialize nodes. It is only intended to work within Blender's python interpreter and requires the bpy module.

node_to_json-0.1.1/README.md

@@ -0,0 +1,4 @@
+# Node To JSON
+
+## Convert Blender 5.2 Nodes to JSON files. Convert JSON objects to Blender Nodes.
+### Created to work with Blender Addons and Extensions to serialize nodes. It is only intended to work within Blender's python interpreter and requires the bpy module.

node_to_json-0.1.1/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "node_to_json"
+version = "0.1.1"
+description = "Blender 5.2 Serialize Node Groups to JSON files.Load Node Groups from JSON files."
+readme = "README.md"
+requires-python = ">=3.13"
+license = "GPL-3.0-only"
+dependencies = []
+
+[[project.authors]]
+name = "Demingo Hill (Noizirom) (C)"
+
+[build-system]
+requires = ["uv_build>=0.12.5,<0.13"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "node_to_json"

node_to_json-0.1.1/pyproject.toml.orig

@@ -0,0 +1,18 @@
+[project]
+name = "node_to_json"
+version = "0.1.1"
+description = "Blender 5.2 Serialize Node Groups to JSON files.Load Node Groups from JSON files."
+readme = "README.md"
+authors = [
+    {name = "Demingo Hill (Noizirom) (C)"}
+]
+requires-python = ">=3.13"
+license = "GPL-3.0-only"
+dependencies = []
+
+[build-system]
+requires = ["uv_build>=0.12.5,<0.13"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "node_to_json"

node_to_json-0.1.1/src/node_to_json/__init__.py

@@ -0,0 +1,53 @@
+"""
+Blender 5.2 
+Serialize Node Groups to JSON files.
+Load Node Groups from JSON files.
+Author: Demingo Hill (Noizirom) (C)
+"""
+from .asset_funcs import get_asset_nodes, asset_node_group, nodes_dir
+from .func_util import nested_dict, convert_attr, convert_default_value, get_node_group_data_type, get_node_groups_by_type, get_reversed_node_groups_by_type
+from .json_io import dict_to_json, json_to_dict
+from .node_getters import serialize_node_group, serialize_mat_group, serialize_material, serialize_comp_group, serialize_compositor, get_node_build_data, get_node_group_interface, get_node_group_names
+from .node_registry import bpy_types_funcs, register_node_setter, ng_getter_funcs, register_ng_getter, ng_setter_funcs, register_ng_setter
+from .node_setters import create_node_group_from_data, add_node_group, create_shader_group_from_data, create_material, add_material_to_ob, create_comp_group, add_comp_group, create_texture_group_from_data, process_node, set_interface
+
+__all__ = [
+    "get_asset_nodes", 
+    "asset_node_group", 
+    "nodes_dir", 
+    "nested_dict", 
+    "convert_attr", 
+    "convert_default_value", 
+    "get_node_group_data_type", 
+    "get_node_groups_by_type", 
+    "get_reversed_node_groups_by_type", 
+    "dict_to_json", 
+    "json_to_dict", 
+    "serialize_node_group", 
+    "serialize_mat_group", 
+    "serialize_material", 
+    "serialize_comp_group", 
+    "serialize_compositor", 
+    "get_node_build_data", 
+    "get_node_group_interface", 
+    "get_node_group_names", 
+    "bpy_types_funcs", 
+    "register_node_setter", 
+    "ng_getter_funcs", 
+    "register_ng_getter", 
+    "ng_setter_funcs", 
+    "register_ng_setter", 
+    "create_node_group_from_data", 
+    "add_node_group", 
+    "create_shader_group_from_data", 
+    "create_material", 
+    "add_material_to_ob", 
+    "create_comp_group", 
+    "add_comp_group", 
+    "create_texture_group_from_data", 
+    "process_node", 
+    "set_interface", 
+    ]
+
+def __dir__():
+    return __all__

node_to_json-0.1.1/src/node_to_json/asset_funcs.py

@@ -0,0 +1,74 @@
+import bpy
+from pathlib import Path
+from typing import Generator
+from .type_util import BGroup
+
+datafiles_path = Path(bpy.utils.system_resource('DATAFILES'))
+lib_relpath = Path("assets").joinpath("nodes")
+nodes_dir = datafiles_path.joinpath(lib_relpath)
+hair_nodes = nodes_dir.joinpath("procedural_hair_node_assets.blend")
+comp_nodes = nodes_dir.joinpath("compositing_nodes_essentials.blend")
+dyn_nodes = nodes_dir.joinpath("geometry_nodes_dynamics_assets.blend")
+geom_nodes = nodes_dir.joinpath("geometry_nodes_essentials.blend")
+principal_nodes = nodes_dir.joinpath("principal_components.blend")
+shading_nodes = nodes_dir.joinpath("shading_nodes_essentials.blend")
+
+
+def get_asset_nodes_helper(file: str) -> Generator[str, None, None]:
+    with bpy.data.libraries.load(str(file), link=True)  as (data_src, data_dst):
+        groups = (g for g in data_src.node_groups)
+        return groups
+
+
+def get_asset_nodes() -> Generator[str, None, None]:
+    for file in nodes_dir.rglob('*blend'):
+        yield from get_asset_nodes_helper(file)
+
+
+
+def get_asset_file(name: str) -> str | None:
+    for file in nodes_dir.rglob('*blend'):
+        if name in get_asset_nodes_helper(file):
+            return file
+    return
+
+
+def append_asset_nodes(*node_groups: str) -> None:
+    for group in node_groups:
+        name = group.split(".")[0]
+        file = get_asset_file(name)
+        if file:
+            with bpy.data.libraries.load(str(file), link=False)  as (data_src, data_dst):
+                data_dst.node_groups = [name]
+    return
+
+
+def get_loaded_node_groups() -> Generator[BGroup, None, None]:
+    return (group for group in bpy.data.node_groups)
+
+
+def get_loaded_node_group_names() -> list[str]:
+    return [group.name for group in get_loaded_node_groups()]
+
+
+def load_asset_node(node_group: str) -> Generator[BGroup, None, None] | None:
+    asset_nodes = set(get_asset_nodes())
+    loaded = set(get_loaded_node_groups())
+    if node_group.split(".")[0] in asset_nodes:
+        append_asset_nodes(node_group.split(".")[0])
+        new_ = get_loaded_node_groups()
+        return (n for n in new_ if n not in loaded)
+    return
+
+
+def asset_node_group(node_group: str) -> BGroup | None:
+    """Add an asset node group or return None.
+    
+    :param node_group: Node group name to load.
+    :type node_group: str
+    :return: Return node group if it is an asset node else return None.
+    :rtype: Node Group | None"""
+    anode = load_asset_node(node_group)
+    if anode not in [None, []]:
+        return next((g for g in anode if g.name.split(".")[0] == node_group.split(".")[0]))
+    return

node_to_json-0.1.1/src/node_to_json/func_util.py

@@ -0,0 +1,90 @@
+import bpy
+from mathutils import Color, Euler, Vector, Matrix, Quaternion
+from idprop.types import IDPropertyArray
+from collections import defaultdict
+from .type_util import PYObject, PYDict, BGroup, BNode
+from operator import itemgetter
+from typing import Generator
+
+
+def nested_dict() -> defaultdict:
+    """Create a nested dict of dicts.
+    
+    :return: dict[str, dict]
+    :rtype: defaultdict"""
+
+    return defaultdict(nested_dict)
+
+
+def convert_attr(val: PYObject | list[PYObject]) -> PYObject | list[PYObject]:
+    """Convert a value based on its bpy type.
+    
+    :param val: Value to modify if it is not serializable.
+    :type val: Any
+    :return: Modified value if it is not serializable, else the original value.
+    :rtype: Any"""
+    
+    if isinstance(val, (Color, Vector, Euler, Quaternion, bpy.types.bpy_prop_array, IDPropertyArray, set, tuple)):
+        return list(val)
+    if isinstance(val, (Matrix,)):
+        return [list(v) for v in val]
+    if isinstance(val, (bpy.types.Object, bpy.types.Material, bpy.types.Image, bpy.types.ImageTexture, bpy.types.Texture, bpy.types.Collection, bpy.types.Scene, bpy.types.Sound, bpy.types.MovieClip, bpy.types.AnimData, bpy.types.Action, bpy.types.Annotation, bpy.types.Mask)):
+        return None
+    if isinstance(val, (bpy.types.Node, bpy.types.GeometryNodeTree, bpy.types.ShaderNodeTree, bpy.types.CompositorNodeTree)):
+        return val.name
+    if isinstance(val, (bpy.types.NodeTreeInterfaceItem, bpy.types.NodeTreeInterfacePanel)):
+        if hasattr(val, 'persistent_uid'):
+            return [val.name, val.persistent_uid]
+        return val.name
+    return val
+
+
+def convert_default_value(_io: BGroup | BNode, val: PYObject) -> PYObject:
+    """Convert a value to a suitable value.
+    
+    :param _io: An object. typically an input / output socket.
+    :type _io: NodeSocket
+    :param val: Default value to set socket to.
+    :type val: Any
+    :return: The modified value if it meets the condition, else it returns the original value.
+    :rtype: Any"""
+    if getattr(_io, 'type', None) == 'INT':
+        val = int(val)
+    if getattr(_io, 'type', None) == 'BOOLEAN':
+        val = bool(val)
+    return val
+
+
+def get_node_group_data_type(data: PYDict) -> str | None:
+    """Get Node Group type from data dict.
+    
+    :param data: Dict with node group build data.
+    :type data: dict[str, Any]
+    :return: Node Group type of data.
+    :rtype: str | None"""
+    get_type = itemgetter('bl_idname')
+    gtype = next(get_type(value) for key, value in data.items())
+    for t in ["GeometryNodeTree", "ShaderNodeTree", "CompositorNodeTree"]:
+        if t == gtype:
+            return t
+    return
+
+
+def get_node_groups_by_type(ng_type: str) -> Generator[bpy.types.NodeGroup, None, None]:
+    """Get a generator of all node groups by type.
+    
+    :param ng_type: Type of node groups to return.
+    :type ng_type: str
+    :return: Generator of node groups by type if they exist.
+    :rtype: Generator[NodeGroup, None, None]"""
+    return (ng for ng in bpy.data.node_groups if ng.bl_idname == ng_type)
+
+
+def get_reversed_node_groups_by_type(ng_type: str) -> Generator[bpy.types.NodeGroup, None, None]:
+    """Get a reversed generator of all node groups by type.
+    
+    :param ng_type: Type of node groups to return.
+    :type ng_type: str
+    :return: Generator of node groups by type in reverse if they exist.
+    :rtype: Generator[NodeGroup, None, None]"""
+    return (ng for ng in reversed(bpy.data.node_groups[:]) if ng.bl_idname == ng_type)

node_to_json-0.1.1/src/node_to_json/json_io.py

@@ -0,0 +1,31 @@
+from json import dump, load
+from .type_util import PYDict
+
+
+def dict_to_json(file: str, data: PYDict, indent: int | None = None) -> None:
+    """Convert python dict to json object.
+    
+    :param file: File path of file to save to.
+    :type file: str
+    :param data: Dict of data to convert.
+    :type data: dict[str, Any]
+    :param indent: How many spaces to indent json object. (None = no indent.)
+    :type indent: int | None"""
+    with open(file, 'w') as f:
+        if indent:
+            dump(data, f, indent=indent)
+        else:
+            dump(data, f)
+
+
+def json_to_dict(file: str) -> PYDict:
+    """Convert json object to python dict.
+    
+    :param file: File path to load from.
+    :type file: str
+    :return: Dict of converted json object
+    :rtype: dict[str, Any]"""
+    with open(file, 'r') as f:
+        data = load(f)
+    return data
+