Skip to content

Enhance save and better docu #59

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
StableLlama merged 3 commits into from
Sep 6, 2026
Merged

Enhance save and better docu #59

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
584ecac
Add (optionally) prompts to the images when saving them
StableLlama Sep 6, 2026
e366c20
Enhance documentation
StableLlama Sep 6, 2026
ceb1b84
Bump to 1.8.1
StableLlama Sep 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.8.1] - 2026-09-06

- Add optional additional input for image saving to also save the prompt when provided
- Enhance in line documentation

## [1.8.0] - 2026-08-31

- Time delta nodes can now be converted to seconds (float) and milliseconds (int)
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"

[project]
name = "basic_data_handling"
version = "1.8.0"
version = "1.8.1"
description = """Basic Python functions for manipulating data that every programmer is used to, lightweight with no additional dependencies.

Supported data types:
Expand Down
88 changes: 53 additions & 35 deletions src/basic_data_handling/boolean_nodes.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,20 +18,23 @@ class IO:

class BooleanAnd(ComfyNodeABC):
"""
Returns the logical AND result of two boolean values.
Returns the logical AND (conjunction) of two boolean values.

This node takes two boolean inputs and returns their logical AND result.
Outputs True only when both inputs are True. This matches the behaviour of the
Python ``and`` operator applied to the two operands.
"""
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"input1": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input2": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input1": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "First operand."}),
"input2": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "Second operand."}),
}
}

RETURN_TYPES = (IO.BOOLEAN,)
RETURN_NAMES = ("result",)
OUTPUT_TOOLTIPS = ("True only when both inputs are True, otherwise False.",)
CATEGORY = "Basic/BOOLEAN"
DESCRIPTION = cleandoc(__doc__ or "")
FUNCTION = "and_operation"
Expand All @@ -42,20 +45,22 @@ def and_operation(self, input1: bool, input2: bool) -> tuple[bool]:

class BooleanNand(ComfyNodeABC):
"""
Returns the logical NAND result of two boolean values.
Returns the logical NAND of two boolean values.

This node takes two boolean inputs and returns their logical NAND result.
Outputs False only when both inputs are True; it is the negation of AND.
"""
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"input1": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input2": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input1": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "First operand."}),
"input2": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "Second operand."}),
}
}

RETURN_TYPES = (IO.BOOLEAN,)
RETURN_NAMES = ("result",)
OUTPUT_TOOLTIPS = ("False only when both inputs are True, otherwise True.",)
CATEGORY = "Basic/BOOLEAN"
DESCRIPTION = cleandoc(__doc__ or "")
FUNCTION = "nand_operation"
Expand All @@ -66,20 +71,22 @@ def nand_operation(self, input1: bool, input2: bool) -> tuple[bool]:

class BooleanNor(ComfyNodeABC):
"""
Returns the logical NOR result of two boolean values.
Returns the logical NOR of two boolean values.

This node takes two boolean inputs and returns their logical NOR result.
Outputs True only when both inputs are False; it is the negation of OR.
"""
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"input1": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input2": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input1": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "First operand."}),
"input2": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "Second operand."}),
}
}

RETURN_TYPES = (IO.BOOLEAN,)
RETURN_NAMES = ("result",)
OUTPUT_TOOLTIPS = ("True only when both inputs are False, otherwise False.",)
CATEGORY = "Basic/BOOLEAN"
DESCRIPTION = cleandoc(__doc__ or "")
FUNCTION = "nor_operation"
Expand All @@ -90,19 +97,21 @@ def nor_operation(self, input1: bool, input2: bool) -> tuple[bool]:

class BooleanNot(ComfyNodeABC):
"""
Returns the logical NOT result of a boolean value.
Returns the logical NOT (negation) of a boolean value.

This node takes one boolean input and returns its logical NOT result.
Outputs True when the input is False and False when the input is True.
"""
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"input": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "The value to negate."}),
}
}

RETURN_TYPES = (IO.BOOLEAN,)
RETURN_NAMES = ("result",)
OUTPUT_TOOLTIPS = ("True when the input is False, False when the input is True.",)
CATEGORY = "Basic/BOOLEAN"
DESCRIPTION = cleandoc(__doc__ or "")
FUNCTION = "not_operation"
Expand All @@ -113,20 +122,23 @@ def not_operation(self, input: bool) -> tuple[bool]:

class BooleanOr(ComfyNodeABC):
"""
Returns the logical OR result of two boolean values.
Returns the logical OR (disjunction) of two boolean values.

This node takes two boolean inputs and returns their logical OR result.
Outputs True when at least one input is True. This matches the behaviour of the
Python ``or`` operator applied to the two operands.
"""
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"input1": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input2": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input1": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "First operand."}),
"input2": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "Second operand."}),
}
}

RETURN_TYPES = (IO.BOOLEAN,)
RETURN_NAMES = ("result",)
OUTPUT_TOOLTIPS = ("True when at least one input is True, otherwise False.",)
CATEGORY = "Basic/BOOLEAN"
DESCRIPTION = cleandoc(__doc__ or "")
FUNCTION = "or_operation"
Expand All @@ -137,20 +149,22 @@ def or_operation(self, input1: bool, input2: bool) -> tuple[bool]:

class BooleanXor(ComfyNodeABC):
"""
Returns the logical XOR result of two boolean values.
Returns the logical XOR (exclusive or) of two boolean values.

This node takes two boolean inputs and returns their logical XOR result.
Outputs True when the inputs differ from one another and False when they are equal.
"""
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"input1": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input2": (IO.BOOLEAN, {"default": False, "forceInput": True}),
"input1": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "First operand."}),
"input2": (IO.BOOLEAN, {"default": False, "forceInput": True, "tooltip": "Second operand."}),
}
}

RETURN_TYPES = (IO.BOOLEAN,)
RETURN_NAMES = ("result",)
OUTPUT_TOOLTIPS = ("True when the two inputs differ, False when they are equal.",)
CATEGORY = "Basic/BOOLEAN"
DESCRIPTION = cleandoc(__doc__ or "")
FUNCTION = "xor_operation"
Expand All @@ -161,24 +175,26 @@ def xor_operation(self, input1: bool, input2: bool) -> tuple[bool]:

class GenericOr(ComfyNodeABC):
"""
Returns the logical N/OR result of one or more values.
Returns the OR of any number of values, evaluated with Python truthiness.

This node takes a dynamic number of inputs and returns their logical N/OR result.
Note that values are evaluated according Python's rules. I.e. an empty string is
`false`, an integer 0 is also `false`, etc.
Connect additional values to the dynamic item input to add more operands. Because
Python truthiness is used, values such as ``0``, ``""``, ``[]``, ``{}`` and ``None``
count as False. When *invert* is enabled the result is negated (NOR).
"""
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"invert": (IO.BOOLEAN, {"default": False}),
"invert": (IO.BOOLEAN, {"default": False, "tooltip": "When enabled, negates the result (turns OR into NOR)."}),
},
"optional": ContainsDynamicDict({
"item_0": (IO.ANY, {"_dynamic": "number", "widgetType": "STRING"}),
"item_0": (IO.ANY, {"_dynamic": "number", "widgetType": "STRING", "tooltip": "One of the values to combine. Connect more values to add operands."}),
})
}

RETURN_TYPES = (IO.BOOLEAN,)
RETURN_NAMES = ("result",)
OUTPUT_TOOLTIPS = ("True when at least one connected value is truthy (unless inverted).",)
CATEGORY = "Basic/BOOLEAN"
DESCRIPTION = cleandoc(__doc__ or "")
FUNCTION = "or_operation"
Expand All @@ -189,24 +205,26 @@ def or_operation(self, invert: bool, **kwargs: list[Any]) -> tuple[bool]:

class GenericAnd(ComfyNodeABC):
"""
Returns the logical N/AND result of one or more values.
Returns the AND of any number of values, evaluated with Python truthiness.

This node takes a dynamic number of inputs and returns their logical N/AND result.
Note that values are evaluated according Python's rules. I.e. an empty string is
`false`, an integer 0 is also `false`, etc.
Connect additional values to the dynamic item input to add more operands. Because
Python truthiness is used, values such as ``0``, ``""``, ``[]``, ``{}`` and ``None``
count as False. When *invert* is enabled the result is negated (NAND).
"""
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"invert": (IO.BOOLEAN, {"default": False}),
"invert": (IO.BOOLEAN, {"default": False, "tooltip": "When enabled, negates the result (turns AND into NAND)."}),
},
"optional": ContainsDynamicDict({
"item_0": (IO.ANY, {"_dynamic": "number", "widgetType": "STRING", "default": "True"}),
"item_0": (IO.ANY, {"_dynamic": "number", "widgetType": "STRING", "default": "True", "tooltip": "One of the values to combine. Connect more values to add operands."}),
})
}

RETURN_TYPES = (IO.BOOLEAN,)
RETURN_NAMES = ("result",)
OUTPUT_TOOLTIPS = ("True when all connected values are truthy (unless inverted).",)
CATEGORY = "Basic/BOOLEAN"
DESCRIPTION = cleandoc(__doc__ or "")
FUNCTION = "and_operation"
Expand Down
Loading
Loading