summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Haller <thaller@redhat.com>2021-06-09 12:03:14 +0200
committerThomas Haller <thaller@redhat.com>2021-06-09 12:46:32 +0200
commit85c6ab97ef53df8b37d52d32f0ba832dc255f013 (patch)
tree68d9a40eb6209af110950841487d1f3b9182ba2e
parente831a67cbc9c923d6efe8bc57de5b156d45d24c0 (diff)
downloadNetworkManager-al/1963854-bond-option.tar.gz
tools: add debug printf statements to "tools/generate-docs-nm-settings-docs-merge.py"al/1963854-bond-option
It's hard to understand what "tools/generate-docs-nm-settings-docs-merge.py" does. Add dbg() statements that are all NOP by default. But the user can easily patch the code to print what is happening. This is only for debugging the script.
-rwxr-xr-xtools/generate-docs-nm-settings-docs-merge.py22
1 files changed, 22 insertions, 0 deletions
diff --git a/tools/generate-docs-nm-settings-docs-merge.py b/tools/generate-docs-nm-settings-docs-merge.py
index a478ae75a3..33c8eff0df 100755
--- a/tools/generate-docs-nm-settings-docs-merge.py
+++ b/tools/generate-docs-nm-settings-docs-merge.py
@@ -9,6 +9,14 @@ import xml.etree.ElementTree as ET
###############################################################################
+
+def dbg(msg):
+ pass
+ # print("%s" % (msg,))
+
+
+###############################################################################
+
_setting_name_order = [
"connection",
"6lowpan",
@@ -123,6 +131,9 @@ gl_input_files = list(argv[1:])
###############################################################################
+for f in gl_input_files:
+ dbg("> input file %s" % (f))
+
xml_roots = list([ET.parse(f).getroot() for f in gl_input_files])
assert all([root.tag == "nm-setting-docs" for root in xml_roots])
@@ -133,14 +144,18 @@ root_node = ET.Element("nm-setting-docs")
for setting_name in iter_keys_of_dicts(settings_roots, key_fcn_setting_name):
+ dbg("> > setting_name: %s" % (setting_name))
+
settings = list([d.get(setting_name) for d in settings_roots])
if gl_only_from_first and settings[0] is None:
+ dbg("> > > skip (only-from-first")
continue
properties = list([node_to_dict(s, "property", "name") for s in settings])
if gl_only_from_first and not properties[0]:
+ dbg("> > > skip (no properties")
continue
setting_node = ET.SubElement(root_node, "setting")
@@ -151,17 +166,24 @@ for setting_name in iter_keys_of_dicts(settings_roots, key_fcn_setting_name):
node_set_attr(setting_node, "name_upper", settings)
node_set_attr(setting_node, "alias", settings)
+ dbg("> > > create node")
+
for property_name in iter_keys_of_dicts(properties):
+ dbg("> > > > property_name: %s" % (property_name))
+
properties_attrs = list([p.get(property_name) for p in properties])
if gl_only_from_first and properties_attrs[0] is None:
+ dbg("> > > > skip (only-from-first")
continue
property_node = ET.SubElement(setting_node, "property")
property_node.set("name", property_name)
property_node.set("name_upper", property_name.upper().replace("-", "_"))
+ dbg("> > > > > create node")
+
x = node_get_attr(properties_attrs, "format")
if x:
property_node.set("type", x)