From 390aa738bc0514dcac6f86efcb19c37afe3c0603 Mon Sep 17 00:00:00 2001
From: "Lex Darlog (DRL)" <3897975+Lex-DRL@users.noreply.github.com>
Date: Tue, 14 Apr 2026 06:53:25 -0300
Subject: [PATCH] `DictFromText`

---
 node_dict_from_text.py | 159 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 159 insertions(+)
 create mode 100644 node_dict_from_text.py

diff --git a/node_dict_from_text.py b/node_dict_from_text.py
new file mode 100644
index 0000000..1212fb4
--- /dev/null
+++ b/node_dict_from_text.py
@@ -0,0 +1,159 @@
+# encoding: utf-8
+"""Code for the ``Dict from Text`` node."""
+
+from inspect import cleandoc as _cleandoc
+
+from comfy_api.latest import io as _io, ui as _ui
+
+from .__meta import (
+	category as _category,
+	pack_id_suffix as _pack_id
+)
+from .__typing import _A, _U, _O, _t, T as _T, FormatDict as _FormatDict
+from ._dict import _new_updated_dict
+from ._io_custom import (
+	_BaseNode,
+	_DICT_INPUT_OPTIONAL, _DICT_OUTPUT,
+	_input_override, _schema_old_name
+)
+from .docstring_formatter import format_docstring as _format_docstring
+
+_dict = dict
+
+# ----------------------------------------------------------
+
+def _return_line_raw(line_raw: str, line_stripped:str) -> str:
+	return line_raw
+
+
+def _return_line_stripped(line_raw: str, line_stripped:str) -> str:
+	return line_stripped
+
+
+def _parsed_kv_pairs_gen(multiline_str: str, strip_lines=True):
+	"""Parse the "dict text" into sequence of key-value pairs:
+	Given a multiline string, extract keywords (first non-empty line in each chunk)
+	and their substrings (all the following non-empty lines).
+	"""
+	if not multiline_str:
+		return
+	multiline_str = str(multiline_str)
+	if not multiline_str.strip():
+		return
+
+	appended_line_f = _return_line_stripped if strip_lines else _return_line_raw
+	cur_chunk: _t.List[str] = list()
+
+	def dump_chunk():
+		cur_chunk_iter = iter(cur_chunk)  # It's more backwards-compatible than `a, *b = x`
+		chunk_key = next(cur_chunk_iter)
+		cur_chunk_lines = list(cur_chunk_iter)
+		# If there are no actual lines, join() would return an empty string:
+		return chunk_key.strip(), '\n'.join(cur_chunk_lines)
+
+	for line in multiline_str.splitlines():
+		line_stripped: str = line.strip()
+		if line_stripped:
+			cur_chunk.append(appended_line_f(line, line_stripped))
+			continue
+
+		assert not line_stripped
+		if cur_chunk:
+			yield dump_chunk()
+			cur_chunk = list()
+
+		# We simply skip all the empty lines entirely
+
+	if cur_chunk:
+		yield dump_chunk()
+
+# ----------------------------------------------------------
+
+class DictFromText(_BaseNode):
+	"""
+	Build a dict of named sub-strings to be used later in string formatting (text construction).
+	"""
+	_schema = _io.Schema(
+		node_id=f'DictFromText{_pack_id}',
+		display_name='Dict from Text',
+		category=_category,
+		description=_format_docstring(_cleandoc(__doc__)),
+		inputs=[
+			_io.Boolean.Input(
+				'cleanup',
+				tooltip="When enabled, each line in each sub-string is stripped from any spaces at its start and end.",
+				default=True,
+				label_on='leading/trailing spaces',
+				label_off='no',
+			),
+			_io.String.Input(
+				'dict_text', display_name='dict-items text',
+				tooltip=(
+					"Sub-string names followed by their text. Different sub-string chunks are separated by empty lines. Example:\n\n"
+					"char1_short\n1boy, blond, short hair\n\n"
+					"char1_long\n1boy, smiling, blue eyes, blond, short hair,\nwearing a leather jacket, sitting on a bike"
+				),
+				multiline=True,
+			),
+			_io.Boolean.Input(
+				'show_status',
+				tooltip="Show detected string names on the node itself?",
+				default=False,
+				label_on='detected keys',
+				label_off='no',
+			),
+
+			_DICT_INPUT_OPTIONAL,
+		],
+		outputs=[_DICT_OUTPUT],
+		# hidden=[_io.Hidden.unique_id],
+		is_output_node=True,  # Just to show the status message even if not connected to anything
+	)
+
+	@classmethod
+	def execute(cls,
+		cleanup: bool, dict_text: str, show_status: bool = False,
+		dict: _O[_FormatDict] = None
+	) -> _io.NodeOutput:
+		parsed_items = _parsed_kv_pairs_gen(dict_text, strip_lines=cleanup)
+		new_dict = {k: v for k, v in parsed_items}
+
+		if not new_dict:
+			# No need to create another dict instance if we add nothing:
+			out_dict = _dict() if dict is None else dict
+			out_ui = '' if show_status else None
+			return _io.NodeOutput(out_dict, ui=out_ui)
+
+		out_dict = _new_updated_dict(dict, new_dict)
+		# These two ↑↓ must be in this specific order:
+		# `_new_updated_dict()` also checks both dicts and might throw an error
+		out_ui = None
+		if show_status:
+			status_text = ','.join(new_dict.keys()) if new_dict else ''
+			out_ui = _ui.PreviewText(status_text)
+
+		return _io.NodeOutput(out_dict, ui=out_ui)
+
+# ==========================================================
+# Deprecated node with old ID (for backwards compatibility)
+
+class DictFromTextOld1(_BaseNode):
+	# noinspection PyProtectedMember
+	_schema = _schema_old_name(
+		DictFromText._schema,
+		'StringConstructorDictFromText',
+		inputs=[
+			_input_override(x, id='strings') if x.id == 'dict_text' else x
+			for x in DictFromText._schema.inputs
+		],
+	)
+
+	@classmethod
+	def execute(cls,
+		cleanup: bool, strings: str, show_status: bool = False,
+		dict: _O[_FormatDict] = None
+	) -> _io.NodeOutput:
+		return DictFromText.execute(
+			cleanup=cleanup, dict_text=strings, show_status=show_status,
+			dict=dict
+		)