Project
Function
Sample CLI
gway web.site view-help
References
['help']
Full Code
def view_help(topic="", *args, **kwargs):
"""Render dynamic help based on GWAY introspection and search-style links."""
topic = topic.replace(" ", "/").replace(".", "/").replace("-", "_") if topic else ""
parts = [p for p in topic.strip("/").split("/") if p]
if not parts:
help_info = gw.help()
title = "Available Projects"
content = "<ul>"
for project in help_info["Available Projects"]:
content += f'<li><a href="?topic={project}">{project}</a></li>'
content += "</ul>"
return f"<h1>{title}</h1>{content}"
elif len(parts) == 1:
project = parts[0]
help_info = gw.help(project)
title = f"Help Topics for <code>{project}</code>"
else:
*project_path, maybe_function = parts
obj = gw
for segment in project_path:
obj = getattr(obj, segment, None)
if obj is None:
return f"<h2>Not Found</h2><p>Project path invalid at <code>{segment}</code>.</p>"
project_str = ".".join(project_path)
if hasattr(obj, maybe_function):
function = maybe_function
help_info = gw.help(project_str, function, full=True)
full_name = f"{project_str}.{function}"
title = f"Help for <code>{full_name}</code>"
else:
# It's a project, not a function
help_info = gw.help(project_str)
full_name = f"{project_str}.{maybe_function}"
title = f"Help Topics for <code>{full_name}</code>"
if help_info is None:
return "<h2>Not Found</h2><p>No help found for the given input.</p>"
if "Matches" in help_info:
sections = [_help_section(match, use_query_links=True) for match in help_info["Matches"]]
return f"<h1>{title}</h1>{''.join(sections)}"
return f"<h1>{title}</h1>{_help_section(help_info, use_query_links=True)}"