2026-04-17 18:42:08 -03:00
<!doctype html>
< html lang = "en" >
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width, initial-scale=1, minimum-scale=1" >
2026-08-17 10:20:43 -03:00
< meta name = "generator" content = "pdoc3 0.11.6" >
2026-04-17 18:42:08 -03:00
< title > connpy.cli.run_handler API documentation</ title >
< meta name = "description" content = "" >
< link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/10up-sanitize.css/13.0.0/sanitize.min.css" integrity = "sha512-y1dtMcuvtTMJc1yPgEqF0ZjQbhnc/bFhyvIyVNb9Zk5mIGtqVaAB1Ttl28su8AvFMOY0EwRbAe+HCLqj6W7/KA==" crossorigin >
< link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/10up-sanitize.css/13.0.0/typography.min.css" integrity = "sha512-Y1DYSb995BAfxobCkKepB1BqJJTPrOp3zPL74AWFugHHmmdcvO+C48WLrUOlhGMc0QG7AE3f7gmvvcrmX2fDoA==" crossorigin >
< link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/default.min.css" crossorigin >
< style >: root { --highlight-color : #fe9 }. flex { display : flex !important } body { line-height : 1.5 em }# content { padding : 20 px }# sidebar { padding : 1.5 em ; overflow : hidden }# sidebar > * : last-child { margin-bottom : 2 cm }. http-server-breadcrumbs { font-size : 130 % ; margin : 0 0 15 px 0 }# footer { font-size : .75 em ; padding : 5 px 30 px ; border-top : 1 px solid #ddd ; text-align : right }# footer p { margin : 0 0 0 1 em ; display : inline-block }# footer p : last-child { margin-right : 30 px } h1 , h2 , h3 , h4 , h5 { font-weight : 300 } h1 { font-size : 2.5 em ; line-height : 1.1 em } h2 { font-size : 1.75 em ; margin : 2 em 0 .50 em 0 } h3 { font-size : 1.4 em ; margin : 1.6 em 0 .7 em 0 } h4 { margin : 0 ; font-size : 105 % } h1 : target , h2 : target , h3 : target , h4 : target , h5 : target , h6 : target { background : var ( -- highlight - color ); padding : .2 em 0 } a { color : #058 ; text-decoration : none ; transition : color .2 s ease-in-out } a : visited { color : #503 } a : hover { color : #b62 }. title code { font-weight : bold } h2 [ id ^= "header-" ] { margin-top : 2 em }. ident { color : #900 ; font-weight : bold } pre code { font-size : .8 em ; line-height : 1.4 em ; padding : 1 em ; display : block } code { background : #f3f3f3 ; font-family : "DejaVu Sans Mono" , monospace ; padding : 1 px 4 px ; overflow-wrap : break-word } h1 code { background : transparent } pre { border-top : 1 px solid #ccc ; border-bottom : 1 px solid #ccc ; margin : 1 em 0 }# http-server-module-list { display : flex ; flex-flow : column }# http-server-module-list div { display : flex }# http-server-module-list dt { min-width : 10 % }# http-server-module-list p { margin-top : 0 }. toc ul , # index { list-style-type : none ; margin : 0 ; padding : 0 }# index code { background : transparent }# index h3 { border-bottom : 1 px solid #ddd }# index ul { padding : 0 }# index h4 { margin-top : .6 em ; font-weight : bold }@ media ( min-width : 200ex ) {# index . two-column { column-count : 2 }}@ media ( min-width : 300ex ) {# index . two-column { column-count : 3 }} dl { margin-bottom : 2 em } dl dl : last-child { margin-bottom : 4 em } dd { margin : 0 0 1 em 3 em }# header-classes + dl > dd { margin-bottom : 3 em } dd dd { margin-left : 2 em } dd p { margin : 10 px 0 }. name { background : #eee ; font-size : .85 em ; padding : 5 px 10 px ; display : inline-block ; min-width : 40 % }. name : hover { background : #e0e0e0 } dt : target . name { background : var ( -- highlight - color )}. name > span : first-child { white-space : nowrap }. name . class > span : nth-child ( 2 ) { margin-left : .4 em }. inherited { color : #999 ; border-left : 5 px solid #eee ; padding-left : 1 em }. inheritance em { font-style : normal ; font-weight : bold }. desc h2 { font-weight : 400 ; font-size : 1.25 em }. desc h3 { font-size : 1 em }. desc dt code { background : inherit }. source > summary , . git-link-div { color : #666 ; text-align : right ; font-weight : 400 ; font-size : .8 em ; text-transform : uppercase }. source summary > * { white-space : nowrap ; cursor : pointer }. git-link { color : inherit ; margin-left : 1 em }. source pre { max-height : 500 px ; overflow : auto ; margin : 0 }. source pre code { font-size : 12 px ; overflow : visible ; min-width : max-content }. hlist { list-style : none }. hlist li { display : inline }. hlist li : after { content : ',\2002' }. hlist li : last-child : after { content : none }. hlist . hlist { display : inline ; padding-left : 1 em } img { max-width : 100 % } td { padding : 0 .5 em }. admonition { padding : .1 em 1 em ; margin : 1 em 0 }. admonition-title { font-weight : bold }. admonition . note , . admonition . info , . admonition . important { background : #aef }. admonition . todo , . admonition . versionadded , . admonition . tip , . admonition . hint { background : #dfd }. admonition . warning , . admonition . versionchanged , . admonition . deprecated { background : #fd4 }. admonition . error , . admonition . danger , . admonition . caution { background : lightpink }</ style >
< style media = "screen and (min-width: 700px)" >@ media screen and ( min-width : 700px ) {# sidebar { width : 30 % ; height : 100 vh ; overflow : auto ; position : sticky ; top : 0 }# content { width : 70 % ; max-width : 100 ch ; padding : 3 em 4 em ; border-left : 1 px solid #ddd } pre code { font-size : 1 em }. name { font-size : 1 em } main { display : flex ; flex-direction : row-reverse ; justify-content : flex-end }. toc ul ul , # index ul ul { padding-left : 1 em }. toc > ul > li { margin-top : .5 em }}</ style >
< style media = "print" >@ media print {# sidebar h1 { page-break-before : always }. source { display : none }}@ media print { * { background : transparent !important ; color : #000 !important ; box-shadow : none !important ; text-shadow : none !important } a [ href ] : after { content : " (" attr ( href ) ")" ; font-size : 90 % } a [ href ][ title ] : after { content : none } abbr [ title ] : after { content : " (" attr ( title ) ")" }. ir a : after , a [ href ^= "javascript:" ] : after , a [ href ^= "#" ] : after { content : "" } pre , blockquote { border : 1 px solid #999 ; page-break-inside : avoid } thead { display : table-header-group } tr , img { page-break-inside : avoid } img { max-width : 100 % !important }@ page { margin : 0 . 5cm } p , h2 , h3 { orphans : 3 ; widows : 3 } h1 , h2 , h3 , h4 , h5 , h6 { page-break-after : avoid }}</ style >
< script defer src = "https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js" integrity = "sha512-D9gUyxqja7hBtkWpPWGt9wfbfaMGVt9gnyCvYa+jojwwPHLCzUm5i8rpk7vD7wNee9bA35eYIjobYPaQuKS1MQ==" crossorigin ></ script >
< script > window . addEventListener ( 'DOMContentLoaded' , () => {
hljs . configure ({ languages : [ 'bash' , 'css' , 'diff' , 'graphql' , 'ini' , 'javascript' , 'json' , 'plaintext' , 'python' , 'python-repl' , 'rust' , 'shell' , 'sql' , 'typescript' , 'xml' , 'yaml' ]});
hljs . highlightAll ();
/* Collapse source docstrings */
setTimeout (() => {
[... document . querySelectorAll ( '.hljs.language-python > .hljs-string' )]
. filter ( el => el . innerHTML . length > 200 && [ '"""' , "'''" ]. includes ( el . innerHTML . substring ( 0 , 3 )))
. forEach ( el => {
let d = document . createElement ( 'details' );
d . classList . add ( 'hljs-string' );
d . innerHTML = '<summary>"""</summary>' + el . innerHTML . substring ( 3 );
el . replaceWith ( d );
});
}, 100 );
})</ script >
</ head >
< body >
< main >
< article id = "content" >
< header >
< h1 class = "title" > Module < code > connpy.cli.run_handler</ code ></ h1 >
</ header >
< section id = "section-intro" >
</ section >
< section >
</ section >
< section >
</ section >
< section >
</ section >
< section >
< h2 class = "section-title" id = "header-classes" > Classes</ h2 >
< dl >
< dt id = "connpy.cli.run_handler.RunHandler" >< code class = "flex name class" >
< span > class < span class = "ident" > RunHandler</ span ></ span >
< span > (</ span >< span > app)</ span >
</ code ></ dt >
< dd >
< details class = "source" >
< summary >
< span > Expand source code</ span >
</ summary >
< pre >< code class = "python" > class RunHandler:
def __init__(self, app):
self.app = app
2026-04-30 14:18:41 -03:00
self.print_lock = threading.Lock()
2026-04-17 18:42:08 -03:00
def dispatch(self, args):
if len(args.data) > 1:
args.action = " noderun"
2026-06-01 17:49:19 -03:00
actions = {
" noderun" : self.node_run,
" generate" : self.yaml_generate,
" generate_ai" : self.ai_generate,
" run" : self.yaml_run
}
2026-04-17 18:42:08 -03:00
return actions.get(args.action)(args)
def node_run(self, args):
nodes_filter = args.data[0]
2026-05-28 18:22:00 -03:00
# Resolve and filter nodes through context-aware list_nodes
try:
matched_nodes = self.app.services.nodes.list_nodes(nodes_filter)
except Exception:
matched_nodes = []
if not matched_nodes:
printer.error(f" No nodes found matching filter: {nodes_filter}" )
sys.exit(2)
2026-04-17 18:42:08 -03:00
commands = [" " .join(args.data[1:])]
2026-04-30 14:18:41 -03:00
2026-06-01 17:49:19 -03:00
# Check for Preflight AI simulation
if getattr(args, " preflight_ai" , False):
matched_node_names = [n.get(" name" ) if isinstance(n, dict) else n for n in matched_nodes]
renderer = printer.BlockMarkdownRenderer()
first_chunk = True
status_context = printer.console.status(" [ai_status]Simulating execution...[/ai_status]" )
def callback(chunk):
nonlocal first_chunk
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [engineer][bold]Preflight AI Simulation[/bold][/engineer]" , style=" engineer" ))
first_chunk = False
renderer.feed(chunk)
try:
status_context.start()
self.app.services.ai.predict_execution_results(
matched_node_names,
commands,
chunk_callback=callback
)
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [engineer][bold]Preflight AI Simulation[/bold][/engineer]" , style=" engineer" ))
renderer.flush()
printer.console.print(Rule(style=" engineer" ))
except Exception as e:
printer.error(f" Preflight AI simulation failed: {e}" )
sys.exit(1)
sys.exit(0)
2026-04-17 18:42:08 -03:00
try:
header_printed = False
2026-04-30 14:18:41 -03:00
if hasattr(args, ' test_expected' ) and args.test_expected:
# Mode: Test
def _on_node_complete(unique, node_output, node_status, node_result):
nonlocal header_printed
with self.print_lock:
if not header_printed:
printer.console.print(Rule(" OUTPUT" , style=" header" ))
header_printed = True
printer.test_panel(unique, node_output, node_status, node_result)
results = self.app.services.execution.test_commands(
2026-05-28 18:22:00 -03:00
nodes_filter=matched_nodes,
2026-04-30 14:18:41 -03:00
commands=commands,
expected=args.test_expected,
on_node_complete=_on_node_complete
)
printer.test_summary(results)
else:
# Mode: Normal Run
def _on_node_complete(unique, node_output, node_status):
nonlocal header_printed
with self.print_lock:
if not header_printed:
printer.console.print(Rule(" OUTPUT" , style=" header" ))
header_printed = True
printer.node_panel(unique, node_output, node_status)
results = self.app.services.execution.run_commands(
2026-05-28 18:22:00 -03:00
nodes_filter=matched_nodes,
2026-04-30 14:18:41 -03:00
commands=commands,
on_node_complete=_on_node_complete
)
printer.run_summary(results)
2026-04-17 18:42:08 -03:00
2026-06-01 17:49:19 -03:00
# Analyze execution results if requested
if getattr(args, " analyze" , None) is not None:
printer.console.print()
renderer = printer.BlockMarkdownRenderer()
first_chunk = True
status_context = printer.console.status(" [ai_status]Analyzing execution results...[/ai_status]" )
def callback(chunk):
nonlocal first_chunk
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [architect][bold]Network Architect AI Analysis[/bold][/architect]" , style=" architect" ))
first_chunk = False
renderer.feed(chunk)
query = args.analyze if args.analyze else " " .join(args.data[1:])
try:
status_context.start()
self.app.services.ai.analyze_execution_results(
results,
query=query,
chunk_callback=callback
)
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [architect][bold]Network Architect AI Analysis[/bold][/architect]" , style=" architect" ))
renderer.flush()
printer.console.print(Rule(style=" architect" ))
except Exception as e:
printer.error(f" AI Analysis failed: {e}" )
2026-04-17 18:42:08 -03:00
except ConnpyError as e:
printer.error(str(e))
sys.exit(1)
def yaml_generate(self, args):
if os.path.exists(args.data[0]):
printer.error(f" File ' {args.data[0]}' already exists." )
sys.exit(14)
else:
with open(args.data[0], " w" ) as file:
file.write(get_instructions(" generate" ))
printer.success(f" File {args.data[0]} generated successfully" )
sys.exit()
def yaml_run(self, args):
path = args.data[0]
try:
with open(path, " r" ) as f:
2026-11-09 17:30:43 -03:00
playbook = yaml.safe_load(f)
if not isinstance(playbook, dict):
raise TypeError(" Invalid playbook format: expected a dictionary" )
2026-04-30 14:18:41 -03:00
2026-06-01 17:49:19 -03:00
# Check preflight first before any task runs
if getattr(args, " preflight_ai" , False):
preflight_failed = False
for task in playbook.get(" tasks" , []):
name = task.get(" name" , " Task" )
nodelist = task.get(" nodes" , [])
commands = task.get(" commands" , [])
# Resolve nodes to names
try:
if isinstance(nodelist, str):
resolved_nodes = self.app.services.nodes.list_nodes(nodelist)
elif isinstance(nodelist, list):
resolved_nodes = []
for item in nodelist:
matches = self.app.services.nodes.list_nodes(item)
for m in matches:
if m not in resolved_nodes:
resolved_nodes.append(m)
else:
resolved_nodes = []
except Exception:
resolved_nodes = []
resolved_names = [n.get(" name" ) if isinstance(n, dict) else n for n in resolved_nodes]
printer.console.print(f" \n[bold]Task: {name}[/bold] (Preflight for {len(resolved_names)} nodes)" )
renderer = printer.BlockMarkdownRenderer()
first_chunk = True
status_context = printer.console.status(" [ai_status]Simulating execution...[/ai_status]" )
def callback(chunk):
nonlocal first_chunk
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=f" [engineer][bold]Preflight AI Simulation: {name}[/bold][/engineer]" , style=" engineer" ))
first_chunk = False
renderer.feed(chunk)
try:
status_context.start()
self.app.services.ai.predict_execution_results(
resolved_names,
commands,
chunk_callback=callback
)
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=f" [engineer][bold]Preflight AI Simulation: {name}[/bold][/engineer]" , style=" engineer" ))
renderer.flush()
printer.console.print(Rule(style=" engineer" ))
except Exception as e:
printer.error(f" Preflight AI simulation failed for task {name}: {e}" )
preflight_failed = True
if preflight_failed:
sys.exit(1)
sys.exit(0)
# Standard run
results_all = {}
2026-04-17 18:42:08 -03:00
for task in playbook.get(" tasks" , []):
2026-06-01 17:49:19 -03:00
task_res = self.cli_run(task)
if task_res:
results_all.update(task_res)
# If analyze is enabled, run analysis on accumulated results
if getattr(args, " analyze" , None) is not None:
printer.console.print()
renderer = printer.BlockMarkdownRenderer()
first_chunk = True
status_context = printer.console.status(" [ai_status]Analyzing playbook execution results...[/ai_status]" )
def callback(chunk):
nonlocal first_chunk
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [architect][bold]Network Architect AI Playbook Analysis[/bold][/architect]" , style=" architect" ))
first_chunk = False
renderer.feed(chunk)
query = args.analyze if args.analyze else f" Playbook: {path}"
try:
status_context.start()
self.app.services.ai.analyze_execution_results(
results_all,
query=query,
chunk_callback=callback
)
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [architect][bold]Network Architect AI Playbook Analysis[/bold][/architect]" , style=" architect" ))
renderer.flush()
printer.console.print(Rule(style=" architect" ))
except Exception as e:
printer.error(f" AI Analysis failed: {e}" )
2026-04-30 14:18:41 -03:00
2026-04-17 18:42:08 -03:00
except Exception as e:
printer.error(f" Failed to run playbook {path}: {e}" )
sys.exit(10)
def cli_run(self, script):
2026-04-30 14:18:41 -03:00
name = script.get(" name" , " Task" )
2026-04-17 18:42:08 -03:00
try:
action = script[" action" ]
nodelist = script[" nodes" ]
commands = script[" commands" ]
variables = script.get(" variables" )
output_cfg = script[" output" ]
options = script.get(" options" , {})
except KeyError as e:
2026-04-30 14:18:41 -03:00
printer.error(f" [{name}] ' {e.args[0]}' is mandatory in script" )
2026-04-17 18:42:08 -03:00
sys.exit(11)
stdout = (output_cfg == " stdout" )
folder = output_cfg if output_cfg not in [None, " stdout" ] else None
prompt = options.get(" prompt" )
2026-04-30 14:18:41 -03:00
2026-05-28 18:22:00 -03:00
# Resolve and filter nodes through context-aware list_nodes
try:
if isinstance(nodelist, str):
resolved_nodes = self.app.services.nodes.list_nodes(nodelist)
elif isinstance(nodelist, list):
resolved_nodes = []
for item in nodelist:
matches = self.app.services.nodes.list_nodes(item)
for m in matches:
if m not in resolved_nodes:
resolved_nodes.append(m)
else:
resolved_nodes = []
except Exception:
resolved_nodes = []
if not resolved_nodes:
printer.error(f" [{name}] No nodes found matching filter: {nodelist}" )
sys.exit(11)
nodelist = resolved_nodes
2026-06-01 17:49:19 -03:00
results = {}
2026-04-17 18:42:08 -03:00
try:
2026-04-30 14:18:41 -03:00
header_printed = False
2026-04-17 18:42:08 -03:00
if action == " run" :
# If stdout is true, we stream results as they arrive
2026-04-30 14:18:41 -03:00
def _on_run_complete(unique, node_output, node_status):
nonlocal header_printed
if stdout:
with self.print_lock:
if not header_printed:
printer.console.print(Rule(name.upper(), style=" header" ))
header_printed = True
printer.node_panel(unique, node_output, node_status)
2026-04-17 18:42:08 -03:00
results = self.app.services.execution.run_commands(
nodes_filter=nodelist,
commands=commands,
variables=variables,
parallel=options.get(" parallel" , 10),
2026-05-13 14:16:14 -03:00
timeout=options.get(" timeout" , 20),
2026-04-17 18:42:08 -03:00
folder=folder,
prompt=prompt,
2026-04-30 14:18:41 -03:00
on_node_complete=_on_run_complete
2026-04-17 18:42:08 -03:00
)
2026-04-30 14:18:41 -03:00
# Final Summary
if not stdout and not folder:
with self.print_lock:
printer.console.print(Rule(name.upper(), style=" header" ))
for unique, data in results.items():
output = data[" output" ] if isinstance(data, dict) else data
2026-04-17 18:42:08 -03:00
printer.node_panel(unique, output, 0)
2026-04-30 14:18:41 -03:00
# ALWAYS show the aggregate execution summary at the end
printer.run_summary(results)
2026-04-17 18:42:08 -03:00
elif action == " test" :
expected = script.get(" expected" , [])
2026-04-30 14:18:41 -03:00
# Show test_panel per node ONLY if stdout is True
def _on_test_complete(unique, node_output, node_status, node_result):
nonlocal header_printed
if stdout:
with self.print_lock:
if not header_printed:
printer.console.print(Rule(name.upper(), style=" header" ))
header_printed = True
printer.test_panel(unique, node_output, node_status, node_result)
2026-04-17 18:42:08 -03:00
results = self.app.services.execution.test_commands(
nodes_filter=nodelist,
commands=commands,
expected=expected,
variables=variables,
parallel=options.get(" parallel" , 10),
2026-05-13 14:16:14 -03:00
timeout=options.get(" timeout" , 20),
2026-04-30 14:18:41 -03:00
folder=folder,
2026-04-17 18:42:08 -03:00
prompt=prompt,
2026-04-30 14:18:41 -03:00
on_node_complete=_on_test_complete
2026-04-17 18:42:08 -03:00
)
2026-04-30 14:18:41 -03:00
# ALWAYS show the aggregate summary at the end
printer.test_summary(results)
2026-06-01 17:49:19 -03:00
return results
2026-04-30 14:18:41 -03:00
2026-04-17 18:42:08 -03:00
except ConnpyError as e:
2026-06-01 17:49:19 -03:00
printer.error(str(e))
return {}
def ai_generate(self, args):
from rich.prompt import Prompt
from rich.rule import Rule
from rich.panel import Panel
from rich.syntax import Syntax
2026-07-27 15:47:51 -03:00
from prompt_toolkit import PromptSession
from prompt_toolkit.formatted_text import HTML
from prompt_toolkit.key_binding import KeyBindings
# Helper to get active theme color
def get_theme_color(style_name, fallback=" white" ):
try:
style = printer.connpy_theme.styles.get(style_name)
if style and style.color:
if style.color.is_default: return fallback
return style.color.triplet.hex if style.color.triplet else style.color.name
except: pass
return fallback
user_color = get_theme_color(" user_prompt" , " #00afd7" )
# Configure multiline key bindings: Enter to submit, Ctrl+Enter (c-j) or Alt+Enter for newlines
kb = KeyBindings()
@kb.add(' enter' )
def _(event):
event.current_buffer.validate_and_handle()
@kb.add(' c-j' )
@kb.add(' escape' , ' enter' )
def _(event):
event.current_buffer.insert_text(' \n' )
session = PromptSession(key_bindings=kb)
2026-06-01 17:49:19 -03:00
dest_file = args.data[0]
if os.path.exists(dest_file):
printer.error(f" File ' {dest_file}' already exists." )
sys.exit(14)
chat_history = []
# Consistent layout opening matching global AI (engineer style)
from rich.markdown import Markdown
printer.console.print(Rule(style=" engineer" ))
2026-07-27 15:47:51 -03:00
printer.console.print(Markdown(" **Playbook Builder AI**: Welcome! Describe the automation workflow you want to design.\nType **exit** to quit.\n*Press Enter to submit, or Ctrl+Enter (Alt+Enter) to add a new line.*\n" ))
2026-06-01 17:49:19 -03:00
printer.console.print(Rule(style=" engineer" ))
while True:
try:
2026-07-27 15:47:51 -03:00
user_prompt = session.prompt(
HTML(f'< style fg=" {user_color}"> User (Enter to submit, Ctrl+Enter for newline):< /style> \n' ),
multiline=True
)
2026-06-01 17:49:19 -03:00
except (KeyboardInterrupt, EOFError):
printer.console.print()
printer.warning(" Operation cancelled by user." )
break
if user_prompt.strip().lower() in [" exit" , " quit" ]:
printer.info(" Exiting AI Assistant." )
break
if not user_prompt.strip():
continue
printer.console.print()
renderer = printer.BlockMarkdownRenderer()
first_chunk = True
status_context = printer.console.status(" [ai_status]Agent is thinking...[/ai_status]" )
def callback(chunk):
nonlocal first_chunk
if first_chunk:
try:
status_context.stop()
except:
pass
printer.console.print(Rule(title=" [engineer][bold]Playbook Builder AI[/bold][/engineer]" , style=" engineer" ))
first_chunk = False
renderer.feed(chunk)
try:
status_context.start()
res = self.app.services.ai.build_playbook_chat(
user_prompt,
chat_history=chat_history,
chunk_callback=callback
)
if first_chunk:
try:
status_context.stop()
except:
pass
renderer.flush()
if not first_chunk:
printer.console.print(Rule(style=" engineer" ))
# Update history
if res and " chat_history" in res:
chat_history = res[" chat_history" ]
# Check if the agent returned a validated playbook YAML
if res and " playbook_yaml" in res and res[" playbook_yaml" ]:
yaml_content = res[" playbook_yaml" ]
printer.console.print()
printer.success(" Playbook YAML successfully generated and validated." )
# Show the YAML inside a beautiful panel matching AI style (with engineer borders)
syntax = Syntax(yaml_content, " yaml" , theme=" ansi_dark" , word_wrap=True, background_color=" default" )
panel = Panel(syntax, title=" [engineer][bold]Resulting Playbook[/bold][/engineer]" , border_style=" engineer" , expand=False)
printer.console.print(panel)
# Ask if the user wants to save it
try:
save_confirm = Prompt.ask(
f" \nDo you want to save this playbook to ' {dest_file}' ?" ,
choices=[" y" , " n" , " run" ],
default=" y"
)
except (KeyboardInterrupt, EOFError):
printer.console.print()
printer.warning(" Saving skipped." )
break
choice = save_confirm.strip().lower()
if choice in [" y" , " yes" , " run" ]:
with open(dest_file, " w" ) as f:
f.write(yaml_content)
printer.success(f" Playbook saved successfully to ' {dest_file}'" )
if choice == " run" :
printer.console.print()
printer.info(" Executing the saved playbook..." )
self.yaml_run(args)
break
else:
printer.warning(" Playbook not saved. You can continue describing changes or exit." )
except Exception as e:
printer.error(f" Error in AI chat: {e}" )</ code ></ pre >
2026-04-17 18:42:08 -03:00
</ details >
< div class = "desc" ></ div >
< h3 > Methods</ h3 >
< dl >
2026-06-01 17:49:19 -03:00
< dt id = "connpy.cli.run_handler.RunHandler.ai_generate" >< code class = "name flex" >
< span > def < span class = "ident" > ai_generate</ span ></ span > (< span > self, args)</ span >
</ code ></ dt >
< dd >
< details class = "source" >
< summary >
< span > Expand source code</ span >
</ summary >
< pre >< code class = "python" > def ai_generate(self, args):
from rich.prompt import Prompt
from rich.rule import Rule
from rich.panel import Panel
from rich.syntax import Syntax
2026-07-27 15:47:51 -03:00
from prompt_toolkit import PromptSession
from prompt_toolkit.formatted_text import HTML
from prompt_toolkit.key_binding import KeyBindings
# Helper to get active theme color
def get_theme_color(style_name, fallback=" white" ):
try:
style = printer.connpy_theme.styles.get(style_name)
if style and style.color:
if style.color.is_default: return fallback
return style.color.triplet.hex if style.color.triplet else style.color.name
except: pass
return fallback
user_color = get_theme_color(" user_prompt" , " #00afd7" )
# Configure multiline key bindings: Enter to submit, Ctrl+Enter (c-j) or Alt+Enter for newlines
kb = KeyBindings()
@kb.add(' enter' )
def _(event):
event.current_buffer.validate_and_handle()
@kb.add(' c-j' )
@kb.add(' escape' , ' enter' )
def _(event):
event.current_buffer.insert_text(' \n' )
session = PromptSession(key_bindings=kb)
2026-06-01 17:49:19 -03:00
dest_file = args.data[0]
if os.path.exists(dest_file):
printer.error(f" File ' {dest_file}' already exists." )
sys.exit(14)
chat_history = []
# Consistent layout opening matching global AI (engineer style)
from rich.markdown import Markdown
printer.console.print(Rule(style=" engineer" ))
2026-07-27 15:47:51 -03:00
printer.console.print(Markdown(" **Playbook Builder AI**: Welcome! Describe the automation workflow you want to design.\nType **exit** to quit.\n*Press Enter to submit, or Ctrl+Enter (Alt+Enter) to add a new line.*\n" ))
2026-06-01 17:49:19 -03:00
printer.console.print(Rule(style=" engineer" ))
while True:
try:
2026-07-27 15:47:51 -03:00
user_prompt = session.prompt(
HTML(f'< style fg=" {user_color}"> User (Enter to submit, Ctrl+Enter for newline):< /style> \n' ),
multiline=True
)
2026-06-01 17:49:19 -03:00
except (KeyboardInterrupt, EOFError):
printer.console.print()
printer.warning(" Operation cancelled by user." )
break
if user_prompt.strip().lower() in [" exit" , " quit" ]:
printer.info(" Exiting AI Assistant." )
break
if not user_prompt.strip():
continue
printer.console.print()
renderer = printer.BlockMarkdownRenderer()
first_chunk = True
status_context = printer.console.status(" [ai_status]Agent is thinking...[/ai_status]" )
def callback(chunk):
nonlocal first_chunk
if first_chunk:
try:
status_context.stop()
except:
pass
printer.console.print(Rule(title=" [engineer][bold]Playbook Builder AI[/bold][/engineer]" , style=" engineer" ))
first_chunk = False
renderer.feed(chunk)
try:
status_context.start()
res = self.app.services.ai.build_playbook_chat(
user_prompt,
chat_history=chat_history,
chunk_callback=callback
)
if first_chunk:
try:
status_context.stop()
except:
pass
renderer.flush()
if not first_chunk:
printer.console.print(Rule(style=" engineer" ))
# Update history
if res and " chat_history" in res:
chat_history = res[" chat_history" ]
# Check if the agent returned a validated playbook YAML
if res and " playbook_yaml" in res and res[" playbook_yaml" ]:
yaml_content = res[" playbook_yaml" ]
printer.console.print()
printer.success(" Playbook YAML successfully generated and validated." )
# Show the YAML inside a beautiful panel matching AI style (with engineer borders)
syntax = Syntax(yaml_content, " yaml" , theme=" ansi_dark" , word_wrap=True, background_color=" default" )
panel = Panel(syntax, title=" [engineer][bold]Resulting Playbook[/bold][/engineer]" , border_style=" engineer" , expand=False)
printer.console.print(panel)
# Ask if the user wants to save it
try:
save_confirm = Prompt.ask(
f" \nDo you want to save this playbook to ' {dest_file}' ?" ,
choices=[" y" , " n" , " run" ],
default=" y"
)
except (KeyboardInterrupt, EOFError):
printer.console.print()
printer.warning(" Saving skipped." )
break
choice = save_confirm.strip().lower()
if choice in [" y" , " yes" , " run" ]:
with open(dest_file, " w" ) as f:
f.write(yaml_content)
printer.success(f" Playbook saved successfully to ' {dest_file}'" )
if choice == " run" :
printer.console.print()
printer.info(" Executing the saved playbook..." )
self.yaml_run(args)
break
else:
printer.warning(" Playbook not saved. You can continue describing changes or exit." )
except Exception as e:
printer.error(f" Error in AI chat: {e}" )</ code ></ pre >
</ details >
< div class = "desc" ></ div >
</ dd >
2026-04-17 18:42:08 -03:00
< dt id = "connpy.cli.run_handler.RunHandler.cli_run" >< code class = "name flex" >
< span > def < span class = "ident" > cli_run</ span ></ span > (< span > self, script)</ span >
</ code ></ dt >
< dd >
< details class = "source" >
< summary >
< span > Expand source code</ span >
</ summary >
< pre >< code class = "python" > def cli_run(self, script):
2026-04-30 14:18:41 -03:00
name = script.get(" name" , " Task" )
2026-04-17 18:42:08 -03:00
try:
action = script[" action" ]
nodelist = script[" nodes" ]
commands = script[" commands" ]
variables = script.get(" variables" )
output_cfg = script[" output" ]
options = script.get(" options" , {})
except KeyError as e:
2026-04-30 14:18:41 -03:00
printer.error(f" [{name}] ' {e.args[0]}' is mandatory in script" )
2026-04-17 18:42:08 -03:00
sys.exit(11)
stdout = (output_cfg == " stdout" )
folder = output_cfg if output_cfg not in [None, " stdout" ] else None
prompt = options.get(" prompt" )
2026-04-30 14:18:41 -03:00
2026-05-28 18:22:00 -03:00
# Resolve and filter nodes through context-aware list_nodes
try:
if isinstance(nodelist, str):
resolved_nodes = self.app.services.nodes.list_nodes(nodelist)
elif isinstance(nodelist, list):
resolved_nodes = []
for item in nodelist:
matches = self.app.services.nodes.list_nodes(item)
for m in matches:
if m not in resolved_nodes:
resolved_nodes.append(m)
else:
resolved_nodes = []
except Exception:
resolved_nodes = []
if not resolved_nodes:
printer.error(f" [{name}] No nodes found matching filter: {nodelist}" )
sys.exit(11)
nodelist = resolved_nodes
2026-06-01 17:49:19 -03:00
results = {}
2026-04-17 18:42:08 -03:00
try:
2026-04-30 14:18:41 -03:00
header_printed = False
2026-04-17 18:42:08 -03:00
if action == " run" :
# If stdout is true, we stream results as they arrive
2026-04-30 14:18:41 -03:00
def _on_run_complete(unique, node_output, node_status):
nonlocal header_printed
if stdout:
with self.print_lock:
if not header_printed:
printer.console.print(Rule(name.upper(), style=" header" ))
header_printed = True
printer.node_panel(unique, node_output, node_status)
2026-04-17 18:42:08 -03:00
results = self.app.services.execution.run_commands(
nodes_filter=nodelist,
commands=commands,
variables=variables,
parallel=options.get(" parallel" , 10),
2026-05-13 14:16:14 -03:00
timeout=options.get(" timeout" , 20),
2026-04-17 18:42:08 -03:00
folder=folder,
prompt=prompt,
2026-04-30 14:18:41 -03:00
on_node_complete=_on_run_complete
2026-04-17 18:42:08 -03:00
)
2026-04-30 14:18:41 -03:00
# Final Summary
if not stdout and not folder:
with self.print_lock:
printer.console.print(Rule(name.upper(), style=" header" ))
for unique, data in results.items():
output = data[" output" ] if isinstance(data, dict) else data
2026-04-17 18:42:08 -03:00
printer.node_panel(unique, output, 0)
2026-04-30 14:18:41 -03:00
# ALWAYS show the aggregate execution summary at the end
printer.run_summary(results)
2026-04-17 18:42:08 -03:00
elif action == " test" :
expected = script.get(" expected" , [])
2026-04-30 14:18:41 -03:00
# Show test_panel per node ONLY if stdout is True
def _on_test_complete(unique, node_output, node_status, node_result):
nonlocal header_printed
if stdout:
with self.print_lock:
if not header_printed:
printer.console.print(Rule(name.upper(), style=" header" ))
header_printed = True
printer.test_panel(unique, node_output, node_status, node_result)
2026-04-17 18:42:08 -03:00
results = self.app.services.execution.test_commands(
nodes_filter=nodelist,
commands=commands,
expected=expected,
variables=variables,
parallel=options.get(" parallel" , 10),
2026-05-13 14:16:14 -03:00
timeout=options.get(" timeout" , 20),
2026-04-30 14:18:41 -03:00
folder=folder,
2026-04-17 18:42:08 -03:00
prompt=prompt,
2026-04-30 14:18:41 -03:00
on_node_complete=_on_test_complete
2026-04-17 18:42:08 -03:00
)
2026-04-30 14:18:41 -03:00
# ALWAYS show the aggregate summary at the end
printer.test_summary(results)
2026-06-01 17:49:19 -03:00
return results
2026-04-30 14:18:41 -03:00
2026-04-17 18:42:08 -03:00
except ConnpyError as e:
2026-06-01 17:49:19 -03:00
printer.error(str(e))
return {}</ code ></ pre >
2026-04-17 18:42:08 -03:00
</ details >
< div class = "desc" ></ div >
</ dd >
< dt id = "connpy.cli.run_handler.RunHandler.dispatch" >< code class = "name flex" >
< span > def < span class = "ident" > dispatch</ span ></ span > (< span > self, args)</ span >
</ code ></ dt >
< dd >
< details class = "source" >
< summary >
< span > Expand source code</ span >
</ summary >
< pre >< code class = "python" > def dispatch(self, args):
if len(args.data) > 1:
args.action = " noderun"
2026-06-01 17:49:19 -03:00
actions = {
" noderun" : self.node_run,
" generate" : self.yaml_generate,
" generate_ai" : self.ai_generate,
" run" : self.yaml_run
}
2026-04-17 18:42:08 -03:00
return actions.get(args.action)(args)</ code ></ pre >
</ details >
< div class = "desc" ></ div >
</ dd >
< dt id = "connpy.cli.run_handler.RunHandler.node_run" >< code class = "name flex" >
< span > def < span class = "ident" > node_run</ span ></ span > (< span > self, args)</ span >
</ code ></ dt >
< dd >
< details class = "source" >
< summary >
< span > Expand source code</ span >
</ summary >
< pre >< code class = "python" > def node_run(self, args):
nodes_filter = args.data[0]
2026-05-28 18:22:00 -03:00
# Resolve and filter nodes through context-aware list_nodes
try:
matched_nodes = self.app.services.nodes.list_nodes(nodes_filter)
except Exception:
matched_nodes = []
if not matched_nodes:
printer.error(f" No nodes found matching filter: {nodes_filter}" )
sys.exit(2)
2026-04-17 18:42:08 -03:00
commands = [" " .join(args.data[1:])]
2026-04-30 14:18:41 -03:00
2026-06-01 17:49:19 -03:00
# Check for Preflight AI simulation
if getattr(args, " preflight_ai" , False):
matched_node_names = [n.get(" name" ) if isinstance(n, dict) else n for n in matched_nodes]
renderer = printer.BlockMarkdownRenderer()
first_chunk = True
status_context = printer.console.status(" [ai_status]Simulating execution...[/ai_status]" )
def callback(chunk):
nonlocal first_chunk
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [engineer][bold]Preflight AI Simulation[/bold][/engineer]" , style=" engineer" ))
first_chunk = False
renderer.feed(chunk)
try:
status_context.start()
self.app.services.ai.predict_execution_results(
matched_node_names,
commands,
chunk_callback=callback
)
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [engineer][bold]Preflight AI Simulation[/bold][/engineer]" , style=" engineer" ))
renderer.flush()
printer.console.print(Rule(style=" engineer" ))
except Exception as e:
printer.error(f" Preflight AI simulation failed: {e}" )
sys.exit(1)
sys.exit(0)
2026-04-17 18:42:08 -03:00
try:
header_printed = False
2026-04-30 14:18:41 -03:00
if hasattr(args, ' test_expected' ) and args.test_expected:
# Mode: Test
def _on_node_complete(unique, node_output, node_status, node_result):
nonlocal header_printed
with self.print_lock:
if not header_printed:
printer.console.print(Rule(" OUTPUT" , style=" header" ))
header_printed = True
printer.test_panel(unique, node_output, node_status, node_result)
results = self.app.services.execution.test_commands(
2026-05-28 18:22:00 -03:00
nodes_filter=matched_nodes,
2026-04-30 14:18:41 -03:00
commands=commands,
expected=args.test_expected,
on_node_complete=_on_node_complete
)
printer.test_summary(results)
else:
# Mode: Normal Run
def _on_node_complete(unique, node_output, node_status):
nonlocal header_printed
with self.print_lock:
if not header_printed:
printer.console.print(Rule(" OUTPUT" , style=" header" ))
header_printed = True
printer.node_panel(unique, node_output, node_status)
results = self.app.services.execution.run_commands(
2026-05-28 18:22:00 -03:00
nodes_filter=matched_nodes,
2026-04-30 14:18:41 -03:00
commands=commands,
on_node_complete=_on_node_complete
)
printer.run_summary(results)
2026-04-17 18:42:08 -03:00
2026-06-01 17:49:19 -03:00
# Analyze execution results if requested
if getattr(args, " analyze" , None) is not None:
printer.console.print()
renderer = printer.BlockMarkdownRenderer()
first_chunk = True
status_context = printer.console.status(" [ai_status]Analyzing execution results...[/ai_status]" )
def callback(chunk):
nonlocal first_chunk
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [architect][bold]Network Architect AI Analysis[/bold][/architect]" , style=" architect" ))
first_chunk = False
renderer.feed(chunk)
query = args.analyze if args.analyze else " " .join(args.data[1:])
try:
status_context.start()
self.app.services.ai.analyze_execution_results(
results,
query=query,
chunk_callback=callback
)
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [architect][bold]Network Architect AI Analysis[/bold][/architect]" , style=" architect" ))
renderer.flush()
printer.console.print(Rule(style=" architect" ))
except Exception as e:
printer.error(f" AI Analysis failed: {e}" )
2026-04-17 18:42:08 -03:00
except ConnpyError as e:
printer.error(str(e))
sys.exit(1)</ code ></ pre >
</ details >
< div class = "desc" ></ div >
</ dd >
< dt id = "connpy.cli.run_handler.RunHandler.yaml_generate" >< code class = "name flex" >
< span > def < span class = "ident" > yaml_generate</ span ></ span > (< span > self, args)</ span >
</ code ></ dt >
< dd >
< details class = "source" >
< summary >
< span > Expand source code</ span >
</ summary >
< pre >< code class = "python" > def yaml_generate(self, args):
if os.path.exists(args.data[0]):
printer.error(f" File ' {args.data[0]}' already exists." )
sys.exit(14)
else:
with open(args.data[0], " w" ) as file:
file.write(get_instructions(" generate" ))
printer.success(f" File {args.data[0]} generated successfully" )
sys.exit()</ code ></ pre >
</ details >
< div class = "desc" ></ div >
</ dd >
< dt id = "connpy.cli.run_handler.RunHandler.yaml_run" >< code class = "name flex" >
< span > def < span class = "ident" > yaml_run</ span ></ span > (< span > self, args)</ span >
</ code ></ dt >
< dd >
< details class = "source" >
< summary >
< span > Expand source code</ span >
</ summary >
< pre >< code class = "python" > def yaml_run(self, args):
path = args.data[0]
try:
with open(path, " r" ) as f:
2026-11-09 17:30:43 -03:00
playbook = yaml.safe_load(f)
if not isinstance(playbook, dict):
raise TypeError(" Invalid playbook format: expected a dictionary" )
2026-04-30 14:18:41 -03:00
2026-06-01 17:49:19 -03:00
# Check preflight first before any task runs
if getattr(args, " preflight_ai" , False):
preflight_failed = False
for task in playbook.get(" tasks" , []):
name = task.get(" name" , " Task" )
nodelist = task.get(" nodes" , [])
commands = task.get(" commands" , [])
# Resolve nodes to names
try:
if isinstance(nodelist, str):
resolved_nodes = self.app.services.nodes.list_nodes(nodelist)
elif isinstance(nodelist, list):
resolved_nodes = []
for item in nodelist:
matches = self.app.services.nodes.list_nodes(item)
for m in matches:
if m not in resolved_nodes:
resolved_nodes.append(m)
else:
resolved_nodes = []
except Exception:
resolved_nodes = []
resolved_names = [n.get(" name" ) if isinstance(n, dict) else n for n in resolved_nodes]
printer.console.print(f" \n[bold]Task: {name}[/bold] (Preflight for {len(resolved_names)} nodes)" )
renderer = printer.BlockMarkdownRenderer()
first_chunk = True
status_context = printer.console.status(" [ai_status]Simulating execution...[/ai_status]" )
def callback(chunk):
nonlocal first_chunk
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=f" [engineer][bold]Preflight AI Simulation: {name}[/bold][/engineer]" , style=" engineer" ))
first_chunk = False
renderer.feed(chunk)
try:
status_context.start()
self.app.services.ai.predict_execution_results(
resolved_names,
commands,
chunk_callback=callback
)
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=f" [engineer][bold]Preflight AI Simulation: {name}[/bold][/engineer]" , style=" engineer" ))
renderer.flush()
printer.console.print(Rule(style=" engineer" ))
except Exception as e:
printer.error(f" Preflight AI simulation failed for task {name}: {e}" )
preflight_failed = True
if preflight_failed:
sys.exit(1)
sys.exit(0)
# Standard run
results_all = {}
2026-04-17 18:42:08 -03:00
for task in playbook.get(" tasks" , []):
2026-06-01 17:49:19 -03:00
task_res = self.cli_run(task)
if task_res:
results_all.update(task_res)
# If analyze is enabled, run analysis on accumulated results
if getattr(args, " analyze" , None) is not None:
printer.console.print()
renderer = printer.BlockMarkdownRenderer()
first_chunk = True
status_context = printer.console.status(" [ai_status]Analyzing playbook execution results...[/ai_status]" )
def callback(chunk):
nonlocal first_chunk
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [architect][bold]Network Architect AI Playbook Analysis[/bold][/architect]" , style=" architect" ))
first_chunk = False
renderer.feed(chunk)
query = args.analyze if args.analyze else f" Playbook: {path}"
try:
status_context.start()
self.app.services.ai.analyze_execution_results(
results_all,
query=query,
chunk_callback=callback
)
if first_chunk:
try: status_context.stop()
except: pass
printer.console.print(Rule(title=" [architect][bold]Network Architect AI Playbook Analysis[/bold][/architect]" , style=" architect" ))
renderer.flush()
printer.console.print(Rule(style=" architect" ))
except Exception as e:
printer.error(f" AI Analysis failed: {e}" )
2026-04-30 14:18:41 -03:00
2026-04-17 18:42:08 -03:00
except Exception as e:
printer.error(f" Failed to run playbook {path}: {e}" )
sys.exit(10)</ code ></ pre >
</ details >
< div class = "desc" ></ div >
</ dd >
</ dl >
</ dd >
</ dl >
</ section >
</ article >
< nav id = "sidebar" >
< div class = "toc" >
< ul ></ ul >
</ div >
< ul id = "index" >
< li >< h3 > Super-module</ h3 >
< ul >
< li >< code >< a title = "connpy.cli" href = "index.html" > connpy.cli</ a ></ code ></ li >
</ ul >
</ li >
< li >< h3 >< a href = "#header-classes" > Classes</ a ></ h3 >
< ul >
< li >
< h4 >< code >< a title = "connpy.cli.run_handler.RunHandler" href = "#connpy.cli.run_handler.RunHandler" > RunHandler</ a ></ code ></ h4 >
2026-06-01 17:49:19 -03:00
< ul class = "two-column" >
< li >< code >< a title = "connpy.cli.run_handler.RunHandler.ai_generate" href = "#connpy.cli.run_handler.RunHandler.ai_generate" > ai_generate</ a ></ code ></ li >
2026-04-17 18:42:08 -03:00
< li >< code >< a title = "connpy.cli.run_handler.RunHandler.cli_run" href = "#connpy.cli.run_handler.RunHandler.cli_run" > cli_run</ a ></ code ></ li >
< li >< code >< a title = "connpy.cli.run_handler.RunHandler.dispatch" href = "#connpy.cli.run_handler.RunHandler.dispatch" > dispatch</ a ></ code ></ li >
< li >< code >< a title = "connpy.cli.run_handler.RunHandler.node_run" href = "#connpy.cli.run_handler.RunHandler.node_run" > node_run</ a ></ code ></ li >
< li >< code >< a title = "connpy.cli.run_handler.RunHandler.yaml_generate" href = "#connpy.cli.run_handler.RunHandler.yaml_generate" > yaml_generate</ a ></ code ></ li >
< li >< code >< a title = "connpy.cli.run_handler.RunHandler.yaml_run" href = "#connpy.cli.run_handler.RunHandler.yaml_run" > yaml_run</ a ></ code ></ li >
</ ul >
</ li >
</ ul >
</ li >
</ ul >
</ nav >
</ main >
< footer id = "footer" >
2026-08-17 10:20:43 -03:00
< p > Generated by < a href = "https://pdoc3.github.io/pdoc" title = "pdoc: Python API documentation generator" >< cite > pdoc</ cite > 0.11.6</ a > .</ p >
2026-04-17 18:42:08 -03:00
</ footer >
</ body >
</ html >