nodebpy 0.1.1__py3-none-any.whl → 0.2.1__py3-none-any.whl

nodebpy/types.py

@@ -0,0 +1,445 @@
+from __future__ import annotations
+
+import typing
+from typing import Literal
+
+from bpy.types import (
+    NodeSocket,
+    NodeSocketBool,
+    NodeSocketBundle,
+    NodeSocketClosure,
+    NodeSocketCollection,
+    NodeSocketColor,
+    NodeSocketFloat,
+    NodeSocketGeometry,
+    NodeSocketImage,
+    NodeSocketInt,
+    NodeSocketMaterial,
+    NodeSocketMatrix,
+    NodeSocketMenu,
+    NodeSocketObject,
+    NodeSocketString,
+    NodeSocketVector,
+)
+from mathutils import Euler
+
+if typing.TYPE_CHECKING:
+    from .builder import NodeBuilder, SocketLinker
+
+
+def _is_default_value(value: TYPE_INPUT_ALL):
+    return isinstance(value, (int, float, str, bool, tuple, list, Euler))
+
+
+# Type aliases for node inputs using typing.Union for runtime compatibility
+LINKABLE = typing.Union["NodeBuilder", "SocketLinker", NodeSocket, None]
+TYPE_INPUT_ROTATION = typing.Union[
+    tuple[float, float, float], float, int, Euler, LINKABLE
+]
+TYPE_INPUT_BOOLEAN = typing.Union[
+    bool, LINKABLE, NodeSocketBool, NodeSocketInt, NodeSocketFloat, NodeSocketVector
+]
+TYPE_INPUT_VALUE = typing.Union[float, int, LINKABLE, NodeSocketInt, NodeSocketFloat]
+TYPE_INPUT_INT = typing.Union[
+    int, LINKABLE, NodeSocketInt, NodeSocketInt, NodeSocketInt
+]
+TYPE_INPUT_VECTOR = typing.Union[
+    typing.Tuple[float, float, float],
+    LINKABLE,
+    TYPE_INPUT_INT,
+    TYPE_INPUT_VALUE,
+    TYPE_INPUT_BOOLEAN,
+    NodeSocketVector,
+    NodeSocketColor,
+    TYPE_INPUT_ROTATION,
+]
+
+
+TYPE_INPUT_COLOR = typing.Union[
+    LINKABLE, tuple[float, float, float, float], NodeSocketColor
+]
+TYPE_INPUT_STRING = typing.Union[str, LINKABLE, NodeSocketString]
+TYPE_INPUT_GEOMETRY = typing.Union[LINKABLE, NodeSocketGeometry]
+TYPE_INPUT_OBJECT = typing.Union[LINKABLE, NodeSocketObject]
+TYPE_INPUT_MATERIAL = typing.Union[LINKABLE, NodeSocketMaterial]
+TYPE_INPUT_IMAGE = typing.Union[LINKABLE, NodeSocketImage]
+TYPE_INPUT_COLLECTION = typing.Union[LINKABLE, NodeSocketCollection]
+TYPE_INPUT_MATRIX = typing.Union[LINKABLE, NodeSocketMatrix]
+TYPE_INPUT_GRID = typing.Union[
+    TYPE_INPUT_VALUE, TYPE_INPUT_VECTOR, TYPE_INPUT_BOOLEAN, TYPE_INPUT_INT
+]
+TYPE_INPUT_MENU = typing.Union[LINKABLE, NodeSocketMenu]
+TYPE_INPUT_BUNDLE = typing.Union[LINKABLE, NodeSocketBundle]
+TYPE_INPUT_CLOSURE = typing.Union[LINKABLE, NodeSocketClosure]
+
+TYPE_INPUT_DATA = typing.Union[
+    TYPE_INPUT_VALUE,
+    TYPE_INPUT_INT,
+    TYPE_INPUT_BOOLEAN,
+    TYPE_INPUT_VECTOR,
+    TYPE_INPUT_ROTATION,
+    TYPE_INPUT_MATRIX,
+]
+
+TYPE_INPUT_ALL = typing.Union[
+    TYPE_INPUT_VALUE,
+    TYPE_INPUT_INT,
+    TYPE_INPUT_STRING,
+    TYPE_INPUT_COLOR,
+    TYPE_INPUT_GEOMETRY,
+    TYPE_INPUT_OBJECT,
+    TYPE_INPUT_MATERIAL,
+    TYPE_INPUT_IMAGE,
+    TYPE_INPUT_COLLECTION,
+    TYPE_INPUT_MATRIX,
+    TYPE_INPUT_VECTOR,
+    TYPE_INPUT_BOOLEAN,
+    TYPE_INPUT_MENU,
+    TYPE_INPUT_ROTATION,
+]
+
+_AccumulateFieldDataTypes = Literal["FLOAT", "INT", "FLOAT_VECTOR", "TRANSFORM"]
+
+_AttributeDomains = typing.Literal[
+    "POINT", "EDGE", "FACE", "CORNER", "CURVE", "INSTANCE", "LAYER"
+]
+_DeleteGeometryDomains = typing.Literal[
+    "POINT", "EDGE", "FACE", "CURVE", "INSTANCE", "LAYER"
+]
+_BakedDataTypeValues = (
+    "FLOAT",
+    "INT",
+    "BOOLEAN",
+    "VECTOR",
+    "RGBA",
+    "ROTATION",
+    "MATRIX",
+    "STRING",
+    "GEOMETRY",
+    "BUNDLE",
+)
+_IntegerMathOperations = Literal[
+    "ADD",
+    "SUBTRACT",
+    "MULTIPLY",
+    "DIVIDE",
+    "MULTIPLY_ADD",
+    "ABSOLUTE",
+    "NEGATE",
+    "POWER",
+    "MINIMUM",
+    "MAXIMUM",
+    "SIGN",
+    "DIVIDE_ROUND",
+    "DIVIDE_FLOOR",
+    "DIVIDE_CEIL",
+    "FLOORED_MODULO",
+    "MODULO",
+    "GCD",
+    "LCM",
+]
+_BakeDataTypes = Literal[
+    "FLOAT",
+    "INT",
+    "BOOLEAN",
+    "VECTOR",
+    "RGBA",
+    "ROTATION",
+    "MATRIX",
+    "STRING",
+    "GEOMETRY",
+    "BUNDLE",
+]
+
+_GridDataTypes = Literal[
+    "FLOAT",
+    "INT",
+    "BOOLEAN",
+    "VECTOR",
+]
+_AdvectGridIntegration = Literal[
+    "Semi-Lagrangian",
+    "Midpoint",
+    "Runge-Kutta 3",
+    "Runge-Kutta 4",
+    "MacCormack",
+    "BFECC",
+]
+
+_DeleteGeoemtryModes = Literal["ALL", "EDGE_FACE", "ONLY_FACE"]
+_RandomValueDataTypes = Literal["FLOAT", "INT", "BOOLEAN", "FLOAT_VECTOR"]
+_EvaluateAtIndexDataTypes = Literal[
+    "FLOAT", "INT", "BOOLEAN", "FLOAT_VECTOR", "FLOAT_COLOR", "QUATERNION", "FLOAT4X4"
+]
+_DuplicateElementsDomains = Literal[
+    "POINT", "EDGE", "FACE", "SPLINE", "LAYER", "INSTANCE"
+]
+
+_AttributeDataTypes = Literal[
+    "FLOAT", "INT", "BOOLEAN", "VECTOR", "RGBA", "ROTATION", "MATRIX"
+]
+_MixDataTypes = Literal["FLOAT", "VECTOR", "COLOR", "ROTATION"]
+
+
+_MixColorBlendTypes = Literal[
+    "MIX",
+    "DARKEN",
+    "MULTIPLY",
+    "BURN",
+    "LIGHTEN",
+    "SCREEN",
+    "DODGE",
+    "ADD",
+    "OVERLAY",
+    "SOFT_LIGHT",
+    "LINEAR_LIGHT",
+    "DIFFERENCE",
+    "EXCLUSION",
+    "SUBTRACT",
+    "DIVIDE",
+    "HUE",
+    "SATURATION",
+    "COLOR",
+    "VALUE",
+]
+
+_RaycaseDataTypes = Literal[
+    "FLOAT", "INT", "BOOLEAN", "FLOAT_VECTOR", "FLOAT_COLOR", "QUATERNION", "FLOAT4X4"
+]
+_SampleIndexDataTypes = Literal[
+    "FLOAT", "INT", "BOOLEAN", "FLOAT_VECTOR", "FLOAT_COLOR", "QUATERNION", "FLOAT4X4"
+]
+
+_EvaluateCurveModes = Literal["EVALUATED", "COUNT", "LENGTH"]
+
+_StoreNamedAttributeTypes = Literal[
+    "FLOAT",
+    "INT",
+    "BOOLEAN",
+    "FLOAT_VECTOR",
+    "FLOAT_COLOR",
+    "QUATERNION",
+    "FLOAT4X4",
+    "STRING",
+    "INT8",
+    "FLOAT2",
+    "BYTE_COLOR",
+]
+
+_SocketShapeStructureType = Literal["AUTO", "DYNAMIC", "FIELD", "GRID", "SINGLE"]
+
+_VectorMathOperations = Literal[
+    "ADD",
+    "SUBTRACT",
+    "MULTIPLY",
+    "DIVIDE",
+    "MULTIPLY_ADD",
+    "CROSS_PRODUCT",
+    "PROJECT",
+    "REFLECT",
+    "REFRACT",
+    "FACEFORWARD",
+    "DOT_PRODUCT",
+    "DISTANCE",
+    "LENGTH",
+    "SCALE",
+    "NORMALIZE",
+    "ABSOLUTE",
+    "POWER",
+    "SIGN",
+    "MINIMUM",
+    "MAXIMUM",
+    "FLOOR",
+    "CEIL",
+    "FRACTION",
+    "MODULO",
+    "WRAP",
+    "SNAP",
+    "SINE",
+    "COSINE",
+    "TANGENT",
+]
+
+
+SOCKET_TYPES = Literal[
+    "FLOAT",
+    "INT",
+    "BOOLEAN",
+    "VECTOR",
+    "RGBA",
+    "ROTATION",
+    "MATRIX",
+    "STRING",
+    "MENU",
+    "OBJECT",
+    "GEOMETRY",
+    "COLLECTION",
+    "IMAGE",
+    "MATERIAL",
+    "BUNDLE",
+    "CLOSURE",
+]
+
+SOCKET_COMPATIBILITY = {
+    "VALUE": (
+        "VALUE",
+        "VECTOR",
+        "INT",
+        "BOOLEAN",
+        "RGBA",
+        "ROTATION",
+    ),
+    "INT": (
+        "INT",
+        "VALUE",
+        "BOOLEAN",
+        "VECTOR",
+        "RGBA",
+    ),
+    "BOOLEAN": (
+        "BOOLEAN",
+        "INT",
+        "VALUE",
+        "VECTOR",
+        "RGBA",
+    ),
+    "VECTOR": (
+        "VECTOR",
+        "RGBA",
+        "ROTATION",
+        "VALUE",
+        "INT",
+        "BOOLEAN",
+    ),
+    "RGBA": (
+        "RGBA",
+        "VECTOR",
+        "VALUE",
+        "INT",
+        "BOOLEAN",
+    ),
+    "ROTATION": (
+        "ROTATION",
+        "MATRIX",
+        "VECTOR",
+    ),
+    "MATRIX": (
+        "MATRIX",
+        "ROTATION",
+    ),
+    "STRING": ("STRING",),
+    "MENU": ("MENU",),
+    "OBJECT": ("OBJECT",),
+    "GEOMETRY": ("GEOMETRY",),
+    "COLLECTION": ("COLLECTION",),
+    "IMAGE": ("IMAGE",),
+    "MATERIAL": ("MATERIAL",),
+    "BUNDLE": ("BUNDLE",),
+    "CLOSURE": ("CLOSURE",),
+}
+
+
+class DataTypes:
+    FLOAT = "FLOAT"
+    INT = "INT"
+    BOOL = "BOOL"
+    VECTOR = "VECTOR"
+    ROTATION = "ROTATION"
+    COLOR = "COLOR"
+    RGBA = "RGBA"
+
+
+class AttributeTypes:
+    FLOAT = "FLOAT_VECTOR"
+    INT = "INT"
+    BOOL = "BOOL"
+    VECTOR = "VECTOR"
+    ROTATION = "ROTATION"
+    COLOR = "RGBA"
+    RGBA = "RGBA"
+
+
+FloatInterfaceSubtypes = typing.Literal[
+    "NONE",
+    "PERCENTAGE",
+    "FACTOR",
+    "ANGLE",
+    "TIME",
+    "TIME_ABSOLUTE",
+    "DISTANCE",
+    "WAVELENGTH",
+    "COLOR_TEMPERATURE",
+    "FREQUENCY",
+]
+VectorInterfaceSubtypes = typing.Literal[
+    "NONE",
+    "PERCENTAGE",
+    "FACTOR",
+    "ANGLE",
+    "TIME",
+    "TIME_ABSOLUTE",
+    "DISTANCE",
+    "WAVELENGTH",
+    "COLOR_TEMPERATURE",
+    "FREQUENCY",
+]
+
+IntegerInterfaceSubtypes = typing.Literal["NONE", "PERCENTAGE", "FACTOR"]
+
+StringInterfaceSubtypes = typing.Literal["NONE", "FILE_PATH"]
+
+
+NodeMathItems = typing.Literal[
+    "ADD",  # Add.A + B.
+    "SUBTRACT",  # Subtract.A - B.
+    "MULTIPLY",  # Multiply.A * B.
+    "DIVIDE",  # Divide.A / B.
+    "MULTIPLY_ADD",  # Multiply Add.A * B + C.
+    "POWER",  # Power.A power B.
+    "LOGARITHM",  # Logarithm.Logarithm A base B.
+    "SQRT",  # Square Root.Square root of A.
+    "INVERSE_SQRT",  # Inverse Square Root.1 / Square root of A.
+    "ABSOLUTE",  # Absolute.Magnitude of A.
+    "EXPONENT",  # Exponent.exp(A).
+    "MINIMUM",  # Minimum.The minimum from A and B.
+    "MAXIMUM",  # Maximum.The maximum from A and B.
+    "LESS_THAN",  # Less Than.1 if A < B else 0.
+    "GREATER_THAN",  # Greater Than.1 if A > B else 0.
+    "SIGN",  # Sign.Returns the sign of A.
+    "COMPARE",  # Compare.1 if (A == B) within tolerance C else 0.
+    "SMOOTH_MIN",  # Smooth Minimum.The minimum from A and B with smoothing C.
+    "SMOOTH_MAX",  # Smooth Maximum.The maximum from A and B with smoothing C.
+    "ROUND",  # Round.Round A to the nearest integer. Round upward if the fraction part is 0.5.
+    "FLOOR",  # Floor.The largest integer smaller than or equal A.
+    "CEIL",  # Ceil.The smallest integer greater than or equal A.
+    "TRUNC",  # Truncate.The integer part of A, removing fractional digits.
+    "FRACT",  # Fraction.The fraction part of A.
+    "MODULO",  # Truncated Modulo.The remainder of truncated division using fmod(A,B).
+    "FLOORED_MODULO",  # Floored Modulo.The remainder of floored division.
+    "WRAP",  # Wrap.Wrap value to range, wrap(A,B).
+    "SNAP",  # Snap.Snap to increment, snap(A,B).
+    "PINGPONG",  # Ping-Pong.Wraps a value and reverses every other cycle (A,B).
+    "SINE",  # Sine.sin(A).
+    "COSINE",  # Cosine.cos(A).
+    "TANGENT",  # Tangent.tan(A).
+    "ARCSINE",  # Arcsine.arcsin(A).
+    "ARCCOSINE",  # Arccosine.arccos(A).
+    "ARCTANGENT",  # Arctangent.arctan(A).
+    "ARCTAN2",  # Arctan2.The signed angle arctan(A / B).
+    "SINH",  # Hyperbolic Sine.sinh(A).
+    "COSH",  # Hyperbolic Cosine.cosh(A).
+    "TANH",  # Hyperbolic Tangent.tanh(A).
+    "RADIANS",  # To Radians.Convert from degrees to radians.
+    "DEGREES",  # To Degrees.Convert from radians to degrees.
+]
+NodeBooleanMathItems = typing.Literal[
+    "AND",  # And.True when both inputs are true.
+    "OR",  # Or.True when at least one input is true.
+    "NOT",  # Not.Opposite of the input.
+    "NAND",  # Not And.True when at least one input is false.
+    "NOR",  # Nor.True when both inputs are false.
+    "XNOR",  # Equal.True when both inputs are equal (exclusive nor).
+    "XOR",  # Not Equal.True when both inputs are different (exclusive or).
+    "IMPLY",  # Imply.True unless the first input is true and the second is false.
+    "NIMPLY",  # Subtract.True when the first input is true and the second is false (not imply).
+]

{nodebpy-0.1.1.dist-info → nodebpy-0.2.1.dist-info}/METADATA

@@ -1,20 +1,20 @@
 Metadata-Version: 2.3
 Name: nodebpy
-Version: 0.1.1
+Version: 0.2.1
 Summary: Build nodes in Blender with code
 Author: Brady Johnston
 Author-email: Brady Johnston <brady.johnston@me.com>
 Requires-Dist: arrangebpy>=0.1.0
-Requires-Dist: jsondiff>=2.2.1
-Requires-Dist: syrupy>=5.0.0
-Requires-Dist: tree-clipper>=0.1.1
 Requires-Dist: bpy>=5.0.0 ; extra == 'bpy'
 Requires-Dist: fake-bpy-module>=20260113 ; extra == 'dev'
+Requires-Dist: jsondiff>=2.2.1 ; extra == 'dev'
 Requires-Dist: pytest>=9.0.2 ; extra == 'dev'
 Requires-Dist: pytest-cov>=7.0.0 ; extra == 'dev'
 Requires-Dist: quarto-cli>=1.8.26 ; extra == 'dev'
 Requires-Dist: quartodoc>=0.11.1 ; extra == 'dev'
 Requires-Dist: ruff>=0.14.11 ; extra == 'dev'
+Requires-Dist: syrupy>=5.0.0 ; extra == 'dev'
+Requires-Dist: tree-clipper>=0.1.1 ; extra == 'dev'
 Requires-Dist: ipython>=8.0.0 ; extra == 'jupyter'
 Requires-Python: >=3.11
 Provides-Extra: bpy
@@ -76,7 +76,7 @@ with TreeBuilder("AnotherTree") as tree:
 
     _ = (
         count
-        >> n.Points(position=n.RandomValue.vector(min=(-1, -1, -1)))
+        >> n.Points(position=n.RandomValue.vector(min=-1))
         >> n.InstanceOnPoints(instance=n.Cube(), rotation=rotation)
         >> n.SetPosition(
             position=n.Position() * 2.0 + (0, 0.2, 0.3),

nodebpy-0.2.1.dist-info/RECORD

@@ -0,0 +1,26 @@
+nodebpy/__init__.py,sha256=AcXaVEPnvX1BlraPSSQ-0NR-Ip6cI0WNRqz84xvrTok,285
+nodebpy/arrange.py,sha256=xBHf-lYlvr-BCdI0gHhEn1ETWjEQyYmzgmhIZ1RYal8,11020
+nodebpy/builder.py,sha256=n4Qje1UAWUvOVCFv7KRaF6jDw6kEZPaVcWNLrqNHKlU,52460
+nodebpy/nodes/__init__.py,sha256=OKVeUcCUjhmqsEsGKhgkCVe0iq2dWEqJCgcogx9RShM,12528
+nodebpy/nodes/attribute.py,sha256=hme17msRejaqGHKDwvauHdCKMq7OLZhhi1Ax9Oxb7Wo,15043
+nodebpy/nodes/color.py,sha256=ye1LkcJuebjMlJ8OUlKepSOe8-dhImgoL1uXFG1NamE,1652
+nodebpy/nodes/converter.py,sha256=rzp3LmQ8uiDW1sDZg9x-LWkphBFzUn9dCgzETPI5Cdc,99014
+nodebpy/nodes/experimental.py,sha256=Gxd2lKD5Hr4ClSmFojeZpZQr5AapQebDgTeO9R6EqxE,9561
+nodebpy/nodes/geometry.py,sha256=C1H9JIGtzmzbJY7rsEf8c9PkX6Ja0JUKRcAI6uLS-l4,177510
+nodebpy/nodes/grid.py,sha256=Px92tPr9w-_IWdAzaMMaIbVeRAHWFTQF3QJ1FYPMqGc,50345
+nodebpy/nodes/group.py,sha256=PzQ20PrzgtqgQ2XRU7K1pqA9mW5wyt54bUIaqHjdqD0,289
+nodebpy/nodes/input.py,sha256=i4CmSe4mBxlIru-BnzwUH1C_95Op5JpIMd-QiZY-FWE,60082
+nodebpy/nodes/interface.py,sha256=jobDdF_DpioS25-RfnyPLiKcA40ZfwNhOjdLATBHdDk,14947
+nodebpy/nodes/manual.py,sha256=zhfcbWJxB-lMB6q_fvmPjnYCRbS52gY-BI1171rIu9U,59625
+nodebpy/nodes/output.py,sha256=py1SgNLQfwTG31KQCHFZn6lC5qg8NixMAoJ1KhnT7XQ,2138
+nodebpy/nodes/texture.py,sha256=JyjsE8WrVJ4wpx3xO6uaJ5A8ll7N6FtWBQs0comAD7s,25526
+nodebpy/nodes/vector.py,sha256=ULEOGx71OCD1Rz2egzkz5RhaKc5huC-LUjghovrnPbQ,15283
+nodebpy/nodes/zone.py,sha256=Rc97fUW1PmteAzxODCEpGJbVbfl9PTgnnBHSoBa8188,13543
+nodebpy/screenshot.py,sha256=gXAwGfeK05YL9XIpghv5nQ5cXVgtR35wnLnTVDAh08g,18885
+nodebpy/screenshot_subprocess.py,sha256=bmuyjedROCasEDI-JdjXWVsYoEX5I-asE3KxMVR30qM,15364
+nodebpy/sockets.py,sha256=eU3p0IdCkYQeVRp8XkkDuOR38JTIzniTXKhsXQgx29Q,1011
+nodebpy/types.py,sha256=4IGYzFquYFPNj_h-yKz-VycdodozdaaHSJ9gX6MchTs,10848
+nodebpy-0.2.1.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+nodebpy-0.2.1.dist-info/entry_points.txt,sha256=XvODbWiwSnneYWIYjxFJZmXdntQnapg59Ye2LtCKEN4,42
+nodebpy-0.2.1.dist-info/METADATA,sha256=sHU0fV0C_fUtJaPVR8-xkwxX_6FQ-TieLoT7IZRBdkA,6289
+nodebpy-0.2.1.dist-info/RECORD,,