2. Theory of Operation
2.1. Execution Flow When Producing “doc” Output
The command line argv is read in
ptulsconv.__main__.main()
, which callsptulsconv.commands.convert()
ptulsconv.commands.convert()
reads the input withptuslconv.docparser.doc_parser_visitor()
, which uses theparsimonious
library to parse the input into an abstract syntax tree, which the parser visitor uses to convert into aptulsconv.docparser.doc_entity.SessionDescriptor
, which structures all of the data in the session output.The next action based on the output format. In the case of the “doc” output format, it runs some validations on the input, and calls
ptulsconv.commands.generate_documents()
.ptulsconv.commands.generate_documents()
creates the output folder, creates the Continuity report withptulsconv.pdf.continuity.output_continuity()
(this document requires some special-casing), and at the tail calls…ptulsconv.commands.create_adr_reports()
, which creates folders for
(FIXME finish this)