gdharness 1.3.42 → 1.3.43

package/build/godot/addons/gdharness_editor/declared_values.gd

@@ -1,11 +1,9 @@
 @tool
 extends RefCounted
-
 ## What a property declares beyond its type: the values of its enum and the range it is exported
 ## with, for taking a value by name and for saying when a value written lies outside them.
 
 const GdhRead = preload("reading.gd")
-
 ## The section of layer_names in project.godot naming the layers of each layers hint.
 const LAYER_NAMES: Dictionary[int, String] = {
 	PROPERTY_HINT_LAYERS_2D_PHYSICS: "2d_physics",
@@ -27,7 +25,7 @@ static func layers_in(hint: int, mask: int) -> Array[Dictionary]:
 	for layer: int in range(1, MASK_LAYERS + 1):
 		if mask & (1 << (layer - 1)) == 0:
 			continue
-		var entry: Dictionary = {"layer": layer}
+		var entry: Dictionary = { "layer": layer }
 		var name: String = str(
 			ProjectSettings.get_setting("layer_names/%s/layer_%d" % [LAYER_NAMES[hint], layer], "")
 		)
@@ -119,10 +117,12 @@ static func engine_constants(target: Object, property: String) -> Dictionary:
 ## names by it, as [true, number], or [false, why] naming the values, with [param holder] naming the
 ## target in the refusal. [false, ""] for a word that is a number, which converts as one.
 ##
-## An enum is written by the name of a value as well as its number, since the name is what the script
-## and the inspector show and the number is only where the value happens to sit. Tried as the script
-## spells it, then as the hint does, then as the engine's constant.
-static func enum_by_name(target: Object, declared: Dictionary, word: String, holder: String) -> Array:
+## An enum is written by the name of a value as well as its number, since the name is what the
+## script and the inspector show and the number is only where the value happens to sit. Tried as the
+## script spells it, then as the hint does, then as the engine's constant.
+static func enum_by_name(
+	target: Object, declared: Dictionary, word: String, holder: String
+) -> Array:
 	var property: String = str(declared.get("name", ""))
 	var choices: Dictionary = enum_of(target, declared)
 	var chosen: Variant = enum_named(choices, word)
@@ -144,7 +144,9 @@ static func enum_refusal(
 ) -> String:
 	var ways: String = "by name or by number"
 	if not constants.is_empty():
-		ways = "by name, by number or by the engine's constant, such as %s" % str(constants.keys()[0])
+		ways = (
+			"by name, by number or by the engine's constant, such as %s" % str(constants.keys()[0])
+		)
 	var said: String = (
 		"%s.%s is an enum, and %s is none of its values: send %s %s"
 		% [holder, property, word, _listed(choices), ways]
@@ -163,7 +165,10 @@ static func enum_argument_refusal(
 	called: String, index: int, named: String, word: String, choices: Dictionary
 ) -> String:
 	var said: String = (
-		"%s takes the enum %s as argument %d, and %s is none of its values: send %s by name or by number"
+		(
+			"%s takes the enum %s as argument %d, and %s is none of its values: send %s by name or "
+			+ "by number"
+		)
 		% [called, named, index + 1, word, _listed(choices)]
 	)
 	var close: PackedStringArray = GdhRead.nearest(word, PackedStringArray(choices.keys()))
@@ -174,7 +179,9 @@ static func enum_argument_refusal(
 
 ## Why [param value], given as argument [param index] for the enum [param named], is none of its
 ## [param choices], or "" when it is one. The engine passes any number on.
-static func outside_enum_argument(index: int, named: String, value: Variant, choices: Dictionary) -> String:
+static func outside_enum_argument(
+	index: int, named: String, value: Variant, choices: Dictionary
+) -> String:
 	if typeof(value) != TYPE_INT or choices.values().has(value):
 		return ""
 	return (
@@ -235,7 +242,10 @@ static func outside(target: Object, declared: Dictionary, value: Variant, shown:
 	var hint: int = GdhRead.as_int(declared.get("hint", PROPERTY_HINT_NONE))
 	var hint_string: String = str(declared.get("hint_string", ""))
 	var property: String = str(declared.get("name", ""))
-	if hint == PROPERTY_HINT_ENUM and (typeof(value) == TYPE_STRING or typeof(value) == TYPE_STRING_NAME):
+	if (
+		hint == PROPERTY_HINT_ENUM
+		and (typeof(value) == TYPE_STRING or typeof(value) == TYPE_STRING_NAME)
+	):
 		var names: PackedStringArray = PackedStringArray(enum_values(hint_string).keys())
 		if names.is_empty() or names.has(str(value)):
 			return ""
@@ -308,15 +318,17 @@ static func _listed(choices: Dictionary) -> String:
 	return ", ".join(listed)
 
 
-## A range's end as the script wrote it: the engine's hint gives @export_range(0, 10) as 0.0 and 10.0.
+## A range's end as the script wrote it: the engine's hint gives @export_range(0, 10) as 0.0 and
+## 10.0.
 static func _bound(end: float) -> String:
 	return str(int(end)) if end == floorf(end) and absf(end) < 1e15 else str(end)
 
 
 ## Puts back on [param built] what its script set as it was attached and was not among
-## [param wanted], to the defaults it declares, outside the editor. Attaching runs the script's _init
-## there, which the editor never runs for a script that is not a tool, so a resource_name _init chose
-## was saved as if asked for. A property whose default the engine cannot report is left as made.
+## [param wanted], to the defaults it declares, outside the editor. Attaching runs the script's
+## _init there, which the editor never runs for a script that is not a tool, so a resource_name
+## _init chose was saved as if asked for. A property whose default the engine cannot report is left
+## as made.
 static func unmade(built: Resource, wanted: Dictionary) -> void:
 	var attached: Variant = built.get_script()
 	if Engine.is_editor_hint() or not attached is Script:
@@ -445,17 +457,25 @@ static func runs_script_code(target: Object, name: String) -> bool:
 ## the buses are read from the AudioServer, which holds the project's layout; "the engine changed or
 ## refused the value" left a caller to guess the bus did not exist.
 static func not_held(
-	holder: String, engine_class: String, property: String, declared: Dictionary, given: Array, held: String
+	holder: String,
+	engine_class: String,
+	property: String,
+	declared: Dictionary,
+	given: Array,
+	held: String
 ) -> String:
 	var value: Variant = given[0]
-	var said: String = "%s.%s was given %s and holds %s after it was set" % [holder, property, given[1], held]
+	var said: String = (
+		"%s.%s was given %s and holds %s after it was set" % [holder, property, given[1], held]
+	)
 	var type: int = GdhRead.as_int(declared.get("type", TYPE_NIL))
 	var hint: int = GdhRead.as_int(declared.get("hint", PROPERTY_HINT_NONE))
 	if hint in LAYER_NAMES and typeof(value) == TYPE_INT:
 		return (
 			(
-				"%s: it is a mask of the %s layers, one bit each from layer 1 (1) to layer %d (%d), so it "
-				+ "takes 0 to %d and the engine keeps only those bits. Nothing was written."
+				"%s: it is a mask of the %s layers, one bit each from layer 1 (1) to layer %d "
+				+ "(%d), so it takes 0 to %d and the engine keeps only those bits. Nothing was "
+				+ "written."
 			)
 			% [
 				said,
@@ -477,22 +497,28 @@ static func not_held(
 		return said + ": the engine changed or refused the value, so nothing was written."
 	var close: PackedStringArray = GdhRead.nearest(str(value), names)
 	var nearest: String = (
-		"%s %s" % ["is" if close.size() == 1 else "are", ", ".join(close)] if not close.is_empty() else ""
+		"%s %s" % ["is" if close.size() == 1 else "are", ", ".join(close)]
+		if not close.is_empty()
+		else ""
 	)
 	if bus:
 		# Not "holds Master after it was set": the getter answers the first bus for any name the
 		# layout lacks, and nothing was kept.
 		return (
 			(
-				"%s.bus takes the name of one of the project's audio buses, and %s is none of them, so it "
-				+ "would play on %s; %s. project_info include audio_buses lists them, and "
-				+ "project_settings add_audio_bus adds one. Nothing was written."
+				"%s.bus takes the name of one of the project's audio buses, and %s is none of "
+				+ "them, so it would play on %s; %s. project_info include audio_buses lists them, "
+				+ "and project_settings add_audio_bus adds one. Nothing was written."
 			)
 			% [
 				holder,
 				given[1],
 				AudioServer.get_bus_name(0),
-				"the buses are " + ", ".join(names) if nearest.is_empty() else "the nearest " + nearest
+				(
+					"the buses are " + ", ".join(names)
+					if nearest.is_empty()
+					else "the nearest " + nearest
+				),
 			]
 		)
 	return (
@@ -500,7 +526,11 @@ static func not_held(
 		% [
 			said,
 			given[1],
-			"it lists " + ", ".join(names) if nearest.is_empty() else "the nearest it lists " + nearest
+			(
+				"it lists " + ", ".join(names)
+				if nearest.is_empty()
+				else "the nearest it lists " + nearest
+			),
 		]
 	)
 
@@ -513,7 +543,9 @@ static func held_by_children(node: Node, property: String) -> String:
 	var holders: PackedStringArray = []
 	for child: Node in node.get_children():
 		if property in child:
-			var _added: bool = holders.append("%s (a %s)" % [root.get_path_to(child), child.get_class()])
+			var _added: bool = holders.append(
+				"%s (a %s)" % [root.get_path_to(child), child.get_class()]
+			)
 	if holders.is_empty():
 		return ""
 	if holders.size() == 1:
@@ -523,14 +555,15 @@ static func held_by_children(node: Node, property: String) -> String:
 
 
 ## A sentence for each node path in [param given], by property, that names no node from
-## [param node]. A path is written whatever it names, as the inspector writes one, since the node may
-## be added next; a joint whose node_a named nothing then joined nothing, and no answer said so.
+## [param node]. A path is written whatever it names, as the inspector writes one, since the node
+## may be added next; a joint whose node_a named nothing then joined nothing, and no answer said so.
 static func naming_nothing(node: Node, given: Dictionary) -> Dictionary:
 	var said: Dictionary = {}
 	for property: String in given:
 		if "/" in property or ":" in property:
 			continue
-		# What the node holds, since a path given as text is held as text until the engine stores it.
+		# What the node holds, since a path given as text is held as text until the engine stores
+		# it.
 		var path: Variant = node.get(property)
 		if not path is NodePath:
 			continue
@@ -539,8 +572,8 @@ static func naming_nothing(node: Node, given: Dictionary) -> Dictionary:
 			continue
 		said[property] = (
 			(
-				"%s names no node from %s. It is written, as the editor writes one, since that node may "
-				+ "be added next; until it is, %s finds nothing."
+				"%s names no node from %s. It is written, as the editor writes one, since that "
+				+ "node may be added next; until it is, %s finds nothing."
 			)
 			% [str(named), node.name, property]
 		)
@@ -553,7 +586,10 @@ static func naming_nothing(node: Node, given: Dictionary) -> Dictionary:
 static func no_uniform(material: ShaderMaterial, property: String) -> String:
 	var uniform: String = property.trim_prefix("shader_parameter/")
 	if material.shader == null:
-		return "The ShaderMaterial has no shader, so it has no parameter %s yet; set shader first." % uniform
+		return (
+			"The ShaderMaterial has no shader, so it has no parameter %s yet; set shader first."
+			% uniform
+		)
 	var shader: String = material.shader.resource_path
 	var named: String = shader if not shader.is_empty() else "Its shader"
 	var uniforms: Array = []

package/build/godot/addons/gdharness_editor/file_reads.gd

@@ -1,5 +1,4 @@
 extends RefCounted
-
 ## Scenes and resources read from their files, by the editor's tools and by a headless engine with
 ## none connected, so a read answers the same either way.
 ##
@@ -30,7 +29,10 @@ static func scene_tree(
 	if not laid.get("ok", false):
 		return laid
 	var nodes: Dictionary = laid["nodes"]
-	return {"ok": true, "tree": _entry(nodes, ".", include_properties, include_defaults, depth, 0)}
+	return {
+		"ok": true,
+		"tree": _entry(nodes, ".", include_properties, include_defaults, depth, 0),
+	}
 
 
 ## The node at [param node_path] in [param scene_path] as {ok, name, type, properties}, laid as
@@ -45,7 +47,9 @@ static func scene_node(scene_path: String, node_path: String) -> Dictionary:
 	if not nodes.has(path):
 		return {}
 	var found: Dictionary = nodes[path]
-	return {"ok": true, "name": found["name"], "type": found["type"], "properties": found["properties"]}
+	return {
+		"ok": true, "name": found["name"], "type": found["type"], "properties": found["properties"],
+	}
 
 
 ## The node at [param node_path] in [param scene_path] as [method scene_node] answers it, when it is
@@ -67,7 +71,7 @@ static func scene_node_of_kind(scene_path: String, node_path: String, kind: Stri
 				"ok": true,
 				"name": nodes[path]["name"],
 				"type": found,
-				"properties": nodes[path]["properties"]
+				"properties": nodes[path]["properties"],
 			}
 	else:
 		var hinted: String = said
@@ -79,7 +83,7 @@ static func scene_node_of_kind(scene_path: String, node_path: String, kind: Stri
 		var type: String = str(nodes[at]["type"])
 		if ClassDB.class_exists(type) and ClassDB.is_parent_class(type, kind):
 			var _held: bool = held.append(str(at))
-	return {"ok": false, "error": GdhRead.not_of_kind(said, node_path, found, kind, held)}
+	return { "ok": false, "error": GdhRead.not_of_kind(said, node_path, found, kind, held) }
 
 
 ## [param said], the refusal for [param node_path], which the scene laid as [param nodes] does not
@@ -100,35 +104,38 @@ static func _missing_in(nodes: Dictionary, said: String, node_path: String) -> S
 	var children: Array[String] = nodes[at]["children"]
 	for child: String in children:
 		var _named: bool = names.append(str(nodes[child]["name"]))
-	return GdhRead.missing_below(said, str(nodes["."]["name"]), reached, parts[reached.size()], names)
+	return GdhRead.missing_below(
+		said, str(nodes["."]["name"]), reached, parts[reached.size()], names
+	)
 
 
 ## Every node of [param scene_path] as {ok, nodes}, keyed by path, or a refusal.
 static func _laid(scene_path: String) -> Dictionary:
 	if not FileAccess.file_exists(scene_path):
-		return {"ok": false, "error": "Scene not found: " + scene_path}
+		return { "ok": false, "error": "Scene not found: " + scene_path }
 	# Loaded without naming the type, so a resource handed in by mistake loads as what it is and the
 	# refusal can say so, where asking for a PackedScene printed the loader's error and a backtrace.
 	var loaded: Resource = ResourceLoader.load(scene_path, "", ResourceLoader.CACHE_MODE_IGNORE)
 	if loaded == null:
-		return {"ok": false, "error": "Failed to load %s as a scene" % scene_path}
+		return { "ok": false, "error": "Failed to load %s as a scene" % scene_path }
 	if not loaded is PackedScene:
 		var sort: String = GdhRead.with_article(loaded.get_class())
 		return {
 			"ok": false,
-			"error": "%s is %s, not a scene: resource_edit read reads its properties." % [scene_path, sort]
+			"error":
+			"%s is %s, not a scene: resource_edit read reads its properties." % [scene_path, sort],
 		}
 	var packed: PackedScene = loaded
 	var nodes: Dictionary = {}
 	var refused: String = _lay(packed.get_state(), ".", nodes, [scene_path], packed)
 	if not refused.is_empty():
-		return {"ok": false, "error": refused}
+		return { "ok": false, "error": refused }
 	if not nodes.has("."):
-		return {"ok": false, "error": "%s holds no nodes" % scene_path}
+		return { "ok": false, "error": "%s holds no nodes" % scene_path }
 	var base: SceneState = packed.get_state().get_base_scene_state()
 	if base != null:
 		nodes["."]["inherits"] = base.get_path()
-	return {"ok": true, "nodes": nodes}
+	return { "ok": true, "nodes": nodes }
 
 
 ## Lays the nodes of [param state] into [param nodes] under [param prefix], keyed by their path
@@ -152,8 +159,8 @@ static func _lay(
 		var path: String = _joined(prefix, str(state.get_node_path(index)))
 		var recovered: bool = false
 		if not nodes.has(path) and index > 0 and _overrides(state, index) and ids[index] >= 0:
-			# The engine finds an entry whose node was renamed or moved in the scene it comes from by
-			# the node's unique_id, and keeps the node's new name.
+			# The engine finds an entry whose node was renamed or moved in the scene it comes from
+			# by the node's unique_id, and keeps the node's new name.
 			var parent: String = _joined(prefix, str(state.get_node_path(index, true)))
 			var found: String = _by_id(nodes, _owner_of(nodes, parent, prefix), ids[index])
 			recovered = not found.is_empty()
@@ -164,7 +171,9 @@ static func _lay(
 			var instance: PackedScene = state.get_node_instance(index)
 			if instance != null:
 				if within.has(instance.resource_path):
-					return "%s instances %s, which holds it" % [within.back(), instance.resource_path]
+					return (
+						"%s instances %s, which holds it" % [within.back(), instance.resource_path]
+					)
 				var refused: String = _lay(
 					instance.get_state(), path, nodes, within + [instance.resource_path]
 				)
@@ -178,15 +187,16 @@ static func _lay(
 				nodes[path] = _made("InstancePlaceholder")
 				nodes[path]["instanceOf"] = state.get_node_instance_placeholder(index)
 			elif str(state.get_node_type(index)).is_empty():
-				# An entry for a node of an instance that no longer has it, which the engine skips too.
+				# An entry for a node of an instance that no longer has it, which the engine skips
+				# too.
 				continue
 			else:
 				nodes[path] = _made(str(state.get_node_type(index)))
 				nodes[path]["madeHere"] = loaded != null
 			if ids[index] >= 0:
 				nodes[path]["uniqueId"] = ids[index]
-			# Laid at the root with no scene handed in is a scene the one being read inherits, and the
-			# deepest is laid first, so this is the file that makes the node.
+			# Laid at the root with no scene handed in is a scene the one being read inherits, and
+			# the deepest is laid first, so this is the file that makes the node.
 			if prefix == "." and loaded == null:
 				nodes[path]["inheritedFrom"] = state.get_path()
 		# The name is the state's even for an entry laid already, since an inherited scene names its
@@ -251,8 +261,8 @@ static func _editable_in(scene_path: String, given_scene: PackedScene = null) ->
 
 
 ## The unique_id of each node entry in the text scene at [param scene_path], in the order its state
-## holds them, -1 where an entry has none. All -1 for a binary scene, and for a file whose entries do
-## not number [param count], since SceneState does not give the ids to a script.
+## holds them, -1 where an entry has none. All -1 for a binary scene, and for a file whose entries
+## do not number [param count], since SceneState does not give the ids to a script.
 static func _unique_ids(scene_path: String, count: int) -> Array[int]:
 	var ids: Array[int] = []
 	var _sized: int = ids.resize(count)
@@ -289,8 +299,9 @@ static func _owner_of(nodes: Dictionary, parent: String, prefix: String) -> Stri
 	return at if nodes.has(at) else prefix
 
 
-## The path of the node [param owner] owns whose unique_id is [param id], or "": one under an instance
-## nested below [param owner] belongs to that instance's file, whose ids are numbered apart.
+## The path of the node [param owner] owns whose unique_id is [param id], or "": one under an
+## instance nested below [param owner] belongs to that instance's file, whose ids are numbered
+## apart.
 static func _by_id(nodes: Dictionary, owner: String, id: int) -> String:
 	for path: String in nodes:
 		if path == owner or not (owner == "." or path.begins_with(owner + "/")):
@@ -307,7 +318,7 @@ static func _by_id(nodes: Dictionary, owner: String, id: int) -> String:
 static func _made(type: String) -> Dictionary:
 	var children: Array[String] = []
 	var groups: Array[String] = []
-	return {"name": "", "type": type, "properties": {}, "children": children, "groups": groups}
+	return { "name": "", "type": type, "properties": {}, "children": children, "groups": groups }
 
 
 ## Puts [param path] among [param parent]'s children, at [param at] when the file says where (a node
@@ -342,7 +353,9 @@ static func _entry(
 ) -> Dictionary:
 	var node: Dictionary = nodes[path]
 	var children: Array[Dictionary] = []
-	var data: Dictionary = {"name": node["name"], "type": node["type"], "path": path, "children": children}
+	var data: Dictionary = {
+		"name": node["name"], "type": node["type"], "path": path, "children": children,
+	}
 	# The root's file is the scene being read, so only another node's names a second scene.
 	if path != "." and node.has("instanceOf"):
 		data["instanceOf"] = node["instanceOf"]
@@ -369,7 +382,8 @@ static func _entry(
 		if cells >= 0:
 			data["cellCount"] = cells
 			data["cellsListedBy"] = (
-				"scene_node get with nodePath %s, which lists them as set_tilemap_cells takes them" % path
+				"scene_node get with nodePath %s, which lists them as set_tilemap_cells takes them"
+				% path
 			)
 		if not node.get("madeHere", false):
 			var kept: Array = node.get("setHere", [])
@@ -383,14 +397,16 @@ static func _entry(
 			data["childrenNotListed"] = below.size()
 		return data
 	for child: String in below:
-		children.append(_entry(nodes, child, include_properties, include_defaults, depth, current_depth + 1))
+		children.append(
+			_entry(nodes, child, include_properties, include_defaults, depth, current_depth + 1)
+		)
 	return data
 
 
 ## How many cells a TileMapLayer or TileMap of [param type] holds under the values [param given], or
-## -1 when it is another node or the file sets none of its cells. The file keeps them as packed bytes,
-## which a read of the tree answered with alone, so a caller decoded the base64 to learn what was
-## painted. Only cells the file sets are counted: an instance's come from its own scene.
+## -1 when it is another node or the file sets none of its cells. The file keeps them as packed
+## bytes, which a read of the tree answered with alone, so a caller decoded the base64 to learn what
+## was painted. Only cells the file sets are counted: an instance's come from its own scene.
 static func _cell_count(type: String, given: Dictionary) -> int:
 	if not ClassDB.class_exists(type) or not ClassDB.can_instantiate(type):
 		return -1
@@ -400,7 +416,10 @@ static func _cell_count(type: String, given: Dictionary) -> int:
 	var painted: bool = false
 	for property: Variant in given:
 		var named: String = str(property)
-		if named == "tile_map_data" or (named.begins_with("layer_") and named.ends_with("/tile_data")):
+		if (
+			named == "tile_map_data"
+			or (named.begins_with("layer_") and named.ends_with("/tile_data"))
+		):
 			painted = true
 	if not painted:
 		return -1
@@ -439,7 +458,10 @@ static func _stored(type: String, given: Dictionary, include_defaults: bool) ->
 	if script != null:
 		for declared: Dictionary in script.get_script_property_list():
 			var property: String = str(declared.get("name", ""))
-			if not property.is_empty() and GdhRead.as_int(declared.get("usage", 0)) & PROPERTY_USAGE_STORAGE:
+			if (
+				not property.is_empty()
+				and GdhRead.as_int(declared.get("usage", 0)) & PROPERTY_USAGE_STORAGE
+			):
 				scripted[property] = script.get_property_default_value(property)
 	var values: Dictionary = {}
 	var defaults: Dictionary = {}
@@ -451,7 +473,10 @@ static func _stored(type: String, given: Dictionary, include_defaults: bool) ->
 				bare.set(str(property), given[property])
 		for declared: Dictionary in bare.get_property_list():
 			var property: String = str(declared.get("name", ""))
-			if not property.is_empty() and GdhRead.as_int(declared.get("usage", 0)) & PROPERTY_USAGE_STORAGE:
+			if (
+				not property.is_empty()
+				and GdhRead.as_int(declared.get("usage", 0)) & PROPERTY_USAGE_STORAGE
+			):
 				values[property] = bare.get(property)
 				defaults[property] = plain.get(property)
 		for made: Object in [bare, plain]:
@@ -476,7 +501,7 @@ static func _stored(type: String, given: Dictionary, include_defaults: bool) ->
 			left_out += 1
 			continue
 		answered[property] = serialiser.serialize_value(values[property])
-	return {"properties": answered, "left_out": left_out}
+	return { "properties": answered, "left_out": left_out }
 
 
 ## What a resource file holds, in the form modify takes, so a value read here can be written back.
@@ -488,10 +513,13 @@ static func _stored(type: String, given: Dictionary, include_defaults: bool) ->
 static func resource(res_path: String, include_defaults: bool) -> Dictionary:
 	var file: String = res_path.get_slice("::", 0)
 	if not FileAccess.file_exists(file):
-		return {"ok": false, "error": GdhFileWalk.new().with_nearest_files("No resource at " + file, file)}
+		return {
+			"ok": false,
+			"error": GdhFileWalk.new().with_nearest_files("No resource at " + file, file),
+		}
 	var whole: Resource = ResourceLoader.load(file, "", ResourceLoader.CACHE_MODE_IGNORE)
 	if whole == null:
-		return {"ok": false, "error": "%s did not load as a resource." % file}
+		return { "ok": false, "error": "%s did not load as a resource." % file }
 	# The file's resource is held until the read is done, since what it keeps can depend on it: a
 	# TileSet that goes unlinks its sources, and an atlas source with no TileSet lists none of its
 	# tiles' physics, navigation or custom data.
@@ -500,14 +528,20 @@ static func resource(res_path: String, include_defaults: bool) -> Dictionary:
 		var id: String = res_path.trim_prefix(file + "::")
 		var inner: Resource = _kept_in(whole, file, id, {})
 		if inner == null:
-			return {"ok": false, "error": "%s keeps no resource with the id %s." % [file, id]}
+			return { "ok": false, "error": "%s keeps no resource with the id %s." % [file, id] }
 		loaded = inner
 	# A scene's own properties are its packed bundle, which says nothing a caller can use.
 	if loaded is PackedScene:
 		return {
 			"ok": false,
 			"error":
-			"%s is a scene: scene_tree reads its nodes, and scene_node get one node's properties." % res_path
+			(
+				(
+					"%s is a scene: scene_tree reads its nodes, and scene_node get one node's "
+					+ "properties."
+				)
+				% res_path
+			),
 		}
 
 	var script: Script = loaded.get_script()
@@ -525,13 +559,17 @@ static func resource(res_path: String, include_defaults: bool) -> Dictionary:
 		untooled and file.ends_with(".tres") and not GdhShapes.STORED_APART.has(loaded.get_class())
 	)
 	var set_in_file: Dictionary = (
-		_names_set_in(FileAccess.get_file_as_string(file), res_path.trim_prefix(file).trim_prefix("::"))
+		_names_set_in(
+			FileAccess.get_file_as_string(file), res_path.trim_prefix(file).trim_prefix("::")
+		)
 		if from_file
 		else {}
 	)
 	# A Curve's points are read off one with none, since the engine has no default for point_0.
 	var fresh: Object = (
-		ClassDB.instantiate(loaded.get_class()) if GdhShapes.STORED_APART.has(loaded.get_class()) else null
+		ClassDB.instantiate(loaded.get_class())
+		if GdhShapes.STORED_APART.has(loaded.get_class())
+		else null
 	)
 	for p: Dictionary in GdhShapes.read_properties(loaded):
 		var property: String = str(p.get("name", ""))
@@ -554,7 +592,10 @@ static func resource(res_path: String, include_defaults: bool) -> Dictionary:
 				continue
 		properties[property] = serialiser.serialize_value(value)
 	var answer: Dictionary = {
-		"ok": true, "resourcePath": res_path, "resourceType": loaded.get_class(), "properties": properties
+		"ok": true,
+		"resourcePath": res_path,
+		"resourceType": loaded.get_class(),
+		"properties": properties,
 	}
 	if script != null:
 		answer["script"] = script.resource_path
@@ -566,8 +607,8 @@ static func resource(res_path: String, include_defaults: bool) -> Dictionary:
 	return answer
 
 
-## The names the [code][resource][/code] section of [param text], a .tres file, sets, or those of the
-## embedded resource with the id [param id] when one is given, as a set.
+## The names the [code][resource][/code] section of [param text], a .tres file, sets, or those of
+## the embedded resource with the id [param id] when one is given, as a set.
 static func _names_set_in(text: String, id: String) -> Dictionary:
 	var names: Dictionary = {}
 	var inside: bool = false

package/build/godot/addons/gdharness_editor/file_walk.gd

@@ -23,12 +23,15 @@ static func missing_reason(path: String) -> String:
 		if id == ResourceUID.INVALID_ID or not ResourceUID.has_id(id):
 			return (
 				path
-				+ " does not resolve: no file in the project's uid cache has it, so the file has gone or the"
-				+ " project has not been imported yet (project_import refresh_uids imports it)"
+				+ " does not resolve: no file in the project's uid cache has it, so the file has "
+				+ "gone or the project has not been imported yet (project_import refresh_uids "
+				+ "imports it)"
 			)
 		var resolved: String = ResourceUID.get_id_path(id)
 		return (
-			"" if FileAccess.file_exists(resolved) else path + " names " + resolved + ", which does not exist"
+			""
+			if FileAccess.file_exists(resolved)
+			else path + " names " + resolved + ", which does not exist"
 		)
 	return "" if FileAccess.file_exists(path) else path + " does not exist"
 
@@ -41,7 +44,9 @@ func with_nearest_files(said: String, path: String) -> String:
 	# One the refusal names is the file it refuses, as a script given for a scene is. Word by word,
 	# since res://brain.gd is inside res://brain.gdd.
 	var named: Array[String] = []
-	for word: String in said.replace("\n", " ").replace(",", " ").replace(";", " ").split(" ", false):
+	for word: String in said.replace("\n", " ").replace(",", " ").replace(";", " ").split(
+		" ", false
+	):
 		named.append(word.rstrip(".:"))
 	var namesakes: Array[String] = []
 	for file: String in _namesakes(path):
@@ -78,7 +83,9 @@ func with_nearest_files(said: String, path: String) -> String:
 		)
 	if files.size() <= GdhRead.NAMED_CHILDREN:
 		return "%s. The project's .%s files are %s." % [said, extension, ", ".join(files)]
-	return "%s. None of the project's %d .%s files is named like it." % [said, files.size(), extension]
+	return (
+		"%s. None of the project's %d .%s files is named like it." % [said, files.size(), extension]
+	)
 
 
 # The files in [param path]'s folder named as it is with another extension, leaving out the import