fdo-mirrors/NetworkManager
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git synced 2026-02-03 10:10:28 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

tools: add debug printf statements to "tools/generate-docs-nm-settings-docs-merge.py"

Browse source 
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.
This commit is contained in:
Thomas Haller 2021-06-09 12:03:14 +02:00
parent e831a67cbc
commit 85c6ab97ef
No known key found for this signature in database
GPG key ID: 29C2366E4DFC5728
1 changed files with 22 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
tools/generate-docs-nm-settings-docs-merge.py
View file

@ -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)