From 64ea69bf4dfd15d17276fba55bb1a0b6c1e3c769 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ola=20Gr=C3=B8ttvik?= Date: Tue, 27 Oct 2026 13:08:20 +0000 Subject: [PATCH 1/8] Add HTML docs and build the PDF only when pdflatex is installed --- CHANGELOG.md | 2 + README.md | 2 +- bust/__main__.py | 4 +- bust/editor/diagram.py | 4 +- bust/generation.py | 59 +++-- bust/generators/documentation_generator.py | 107 ++++++++- bust/jinja_utils/environment.py | 27 ++- bust/jinja_utils/filters.py | 12 + bust/templates/html/documentation.j2 | 112 +++++++++ docs/command-line.md | 11 +- docs/getting-started.md | 3 +- docs/headers-and-docs.md | 24 +- docs/index.md | 4 +- docs/register-map-format.md | 8 +- example/example_axi/doc/example_axi.html | 212 +++++++++++++++++ example/example_ipbus/doc/example_ipbus.html | 196 ++++++++++++++++ example/example_prototype/doc/prototype.html | 227 +++++++++++++++++++ scripts/smoke-test.sh | 2 + tests/test_generation.py | 20 +- tests/test_latex.py | 10 +- tests/test_suite.py | 15 +- 21 files changed, 992 insertions(+), 69 deletions(-) create mode 100644 bust/templates/html/documentation.j2 create mode 100644 example/example_axi/doc/example_axi.html create mode 100644 example/example_ipbus/doc/example_ipbus.html create mode 100644 example/example_prototype/doc/prototype.html diff --git a/CHANGELOG.md b/CHANGELOG.md index 5ecf2308..f7c211dd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,8 +11,10 @@ the git log and on [PyPI](https://pypi.org/project/bust/#history). ### Added - `bust.generate_files` returns every output file as `{path: content}`, without writing to disk or running `pdflatex`. The command line writes that result. +- `doc/.html`, the documentation as one self-contained HTML page with inline SVG bit diagrams, links between the register list and the registers, a sidebar and a print stylesheet. ### Changed +- bust builds the PDF only when `pdflatex` is on `PATH`. Without it, bust writes the `.tex` and `.html` files and prints one line saying the PDF was skipped. - `_regfile_pkg` merges `base_match` and `above_registers` into one function, `is_in_range`. ### Removed diff --git a/README.md b/README.md index c6d74526..509eee1e 100644 --- a/README.md +++ b/README.md @@ -75,7 +75,7 @@ A minimal register map with one control register with two fields: bust blinky.json -o out -p ``` -This writes `out/blinky/` with the VHDL in `hdl/`, the testbench in `tb/`, the headers in `header/` and the LaTeX documentation in `doc/`. `hdl/blinky.vhd` is a starter top level that is yours to edit: bust writes it once and leaves it alone after that. Your logic reads `to_hw.ctrl.enable` and `to_hw.ctrl.rate` from `blinky_axi_endpoint`, which bust regenerates on every run. +This writes `out/blinky/` with the VHDL in `hdl/`, the testbench in `tb/`, the headers in `header/` and the documentation in `doc/`, as HTML and LaTeX, plus a PDF when `pdflatex` is installed. `hdl/blinky.vhd` is a starter top level that is yours to edit: bust writes it once and leaves it alone after that. Your logic reads `to_hw.ctrl.enable` and `to_hw.ctrl.rate` from `blinky_axi_endpoint`, which bust regenerates on every run. ## How bust is tested diff --git a/bust/__main__.py b/bust/__main__.py index 369ae04d..27566f18 100644 --- a/bust/__main__.py +++ b/bust/__main__.py @@ -9,8 +9,8 @@ Options: -o DIR Specify output directory (default: the directory of FILE) -f Force overwrite of existing files, except .vhd, which is yours - -d Do not generate documentation (neither LaTeX nor PDF) - -p Do not generate PDF from LaTeX + -d Do not generate documentation (LaTeX, HTML or PDF) + -p Do not generate PDF from LaTeX, even if pdflatex is installed -i Do not generate the include header files (.h, .hpp & .py) --replace-top Replace .vhd with a fresh starter, keeping the old file as .vhd.bak -a Update register addresses and save JSON file (with -f, without asking) diff --git a/bust/editor/diagram.py b/bust/editor/diagram.py index 26a7de37..d3ab8468 100644 --- a/bust/editor/diagram.py +++ b/bust/editor/diagram.py @@ -32,7 +32,7 @@ def _reset(text: str, width: int) -> str: return str(value) if width < 2 else f"0x{value:X}" -def _segments(register: Register, data_width: int) -> List[_Segment]: +def bit_segments(register: Register, data_width: int) -> List[_Segment]: """The fields of `register` from the highest bit down, with the unused bits between them.""" if register.type == RegisterType.FIELDS: @@ -69,7 +69,7 @@ def bit_diagram(register: Register, data_width: int) -> List[str]: the field names, and the reset values.""" bit = bit_width(data_width) numbers = top = names = bottom = resets = "" - for number, segment in enumerate(_segments(register, data_width)): + for number, segment in enumerate(bit_segments(register, data_width)): high, low = str(segment.high), str(segment.low) bits = high if segment.width == 1 else f"{high} {low}" # A box grows past its bits rather than cut a name short. diff --git a/bust/generation.py b/bust/generation.py index 1fbb6d5f..21369eec 100644 --- a/bust/generation.py +++ b/bust/generation.py @@ -69,7 +69,7 @@ def module_outputs( localbus: Include the local-bus VHDL stack, the starter top level and the testbench. headers: Include the language headers. - documentation: Include the LaTeX documentation. + documentation: Include the LaTeX and HTML documentation. Returns: The content of each file by its path relative to the output directory, @@ -108,9 +108,10 @@ def module_outputs( if module.bus.bus_type == "ipbus": outputs[f"{base}.xml"] = header.generate_ipbus_addr_table() if documentation: - outputs[f"{name}/{settings.doc_dir}/{name}.tex"] = DocumentationGenerator( - module - ).generate_tex_documentation() + doc = DocumentationGenerator(module) + base = f"{name}/{settings.doc_dir}/{name}" + outputs[f"{base}.tex"] = doc.generate_tex_documentation() + outputs[f"{base}.html"] = doc.generate_html_documentation() return outputs @@ -199,7 +200,7 @@ def generate_output(settings, module, gen_settings): - gen_localbus: Generate the local-bus VHDL stack and testbench - gen_header: Generate language headers - gen_doc: Generate documentation - - gen_pdf: Generate PDF from LaTeX + - gen_pdf: Generate PDF from LaTeX, if pdflatex is installed """ proj_dir = os.path.expanduser(gen_settings["dir"]) logger.info(f"Project path: {os.path.abspath(proj_dir)}") @@ -220,22 +221,34 @@ def generate_output(settings, module, gen_settings): else: write_string_to_file(content, filename, directory, gen_settings["force_ow"]) - mod_doc = os.path.join(proj_dir, module.name, settings.doc_dir) if gen_settings["gen_pdf"]: - logger.info("Generating Documentation PDF...") - try: - status = subprocess.call( - [ - "pdflatex", - "--interaction=batchmode", - f"--output-directory={mod_doc}", - os.path.join(mod_doc, module.name + ".tex"), - ], - stdout=subprocess.DEVNULL, - ) - except OSError as e: - logger.error(f"Could not run pdflatex ({e}). Use -p to skip the PDF.") - else: - if status != 0: - log = os.path.join(mod_doc, module.name + ".log") - logger.warning(f"pdflatex reported errors. See {log}") + _build_pdf(module, os.path.join(proj_dir, module.name, settings.doc_dir)) + + +def _build_pdf(module, mod_doc): + """Run pdflatex on .tex, or say that the PDF was skipped when + pdflatex is not installed. Neither stops the run.""" + pdflatex = shutil.which("pdflatex") + if pdflatex is None: + logger.info( + "pdflatex is not on PATH, so bust skipped the PDF. " + f"The documentation is in {os.path.join(mod_doc, module.name + '.html')}." + ) + return + logger.info("Generating Documentation PDF...") + try: + status = subprocess.call( + [ + pdflatex, + "--interaction=batchmode", + f"--output-directory={mod_doc}", + os.path.join(mod_doc, module.name + ".tex"), + ], + stdout=subprocess.DEVNULL, + ) + except OSError as e: + logger.error(f"Could not run pdflatex ({e}). Use -p to skip the PDF.") + else: + if status != 0: + log = os.path.join(mod_doc, module.name + ".log") + logger.warning(f"pdflatex reported errors. See {log}") diff --git a/bust/generators/documentation_generator.py b/bust/generators/documentation_generator.py index dc81db9f..590c9dae 100644 --- a/bust/generators/documentation_generator.py +++ b/bust/generators/documentation_generator.py @@ -1,19 +1,96 @@ """Documentation generation module for bust. This module provides the DocumentationGenerator class for automatically generating -LaTeX documentation from module definitions. The generated documentation +LaTeX and HTML documentation from module definitions. The generated documentation includes register maps, bit field descriptions, and access modes. """ +from html import escape + from bust._version import __VERSION__ from bust.core.enums import RegisterType +from bust.editor.diagram import ( + bit_segments, + field_notes, + register_heading, + register_list, +) from bust.jinja_utils.environment import render_template +_FONT = 11 +# An estimate of a character's width at _FONT, enough to tell whether a name +# fits across its box or must be turned on its side. +_CHAR_WIDTH = 7 +_NUMBERS_HEIGHT = 16 +_RESET_HEIGHT = 18 +_MIN_BOX_HEIGHT = 28 + + +def bit_diagram_svg(register, data_width): + """An inline SVG of the bits of `register`, laid out as the LaTeX register + package draws them: a box per field with its name, the numbers of its + highest and lowest bit above it, and its reset value below. + + A name too long for its box is turned on its side, and the boxes grow + taller to fit the longest such name. + """ + bit = 24 if data_width <= 32 else 14 + segments = bit_segments(register, data_width) + is_turned = [len(s.name) * _CHAR_WIDTH + 6 > s.width * bit for s in segments] + box_height = max( + [_MIN_BOX_HEIGHT] + + [ + len(s.name) * _CHAR_WIDTH + 10 + for s, turned in zip(segments, is_turned) + if turned + ] + ) + width = data_width * bit + box_top = _NUMBERS_HEIGHT + height = box_top + box_height + _RESET_HEIGHT + parts = [ + f'' + ] + x = 1 + for segment, turned in zip(segments, is_turned): + w = segment.width * bit + middle = x + w / 2 + name_y = box_top + box_height / 2 + if segment.width == 1: + parts.append(_text(middle, box_top - 4, segment.high, "middle", "num")) + else: + parts.append(_text(x + 3, box_top - 4, segment.high, "start", "num")) + parts.append(_text(x + w - 3, box_top - 4, segment.low, "end", "num")) + css_class = "unused" if segment.name == "unused" else "field" + parts.append( + f'' + ) + rotate = f' transform="rotate(-90 {middle} {name_y})"' if turned else "" + parts.append( + f'' + f"{escape(segment.name)}" + ) + parts.append(_text(middle, height - 4, segment.reset, "middle", "reset")) + x += w + parts.append("") + return "".join(parts) + + +def _text(x, y, text, anchor, css_class): + return ( + f'{escape(str(text))}' + ) + class DocumentationGenerator: """Generates documentation for bus slave modules. - The DocumentationGenerator class creates LaTeX documentation with complete register + The DocumentationGenerator class creates LaTeX and HTML documentation with complete register specifications including addresses, bit positions, access modes, and descriptions. @@ -29,7 +106,7 @@ def __init__(self, module): """ self.module = module - def _render_template(self, template_name, version=None): + def _render_template(self, template_name, version=None, **context): """Render a Jinja2 template with module context. Args: @@ -48,6 +125,7 @@ def _render_template(self, template_name, version=None): "module": self.module, "version": version, "reg_type_fields": RegisterType.FIELDS, + **context, }, ) @@ -64,3 +142,26 @@ def generate_tex_documentation(self, test_version=None): LaTeX document source code as string. """ return self._render_template("latex/documentation.j2", test_version) + + def generate_html_documentation(self, test_version=None): + """Generate the documentation as one self-contained HTML page. + + It follows the layout of the LaTeX documentation, with links from the + register list and a sidebar to each register, and a print stylesheet. + + Args: + test_version: Version string for testing (default: None, uses bust version). + + Returns: + HTML document as string. + """ + headers, rows = register_list(self.module) + return self._render_template( + "html/documentation.j2", + test_version, + list_headers=headers, + list_rows=zip(rows, self.module.registers), + register_heading=register_heading, + field_notes=field_notes, + bit_diagram_svg=bit_diagram_svg, + ) diff --git a/bust/jinja_utils/environment.py b/bust/jinja_utils/environment.py index 534515b1..4a03d982 100644 --- a/bust/jinja_utils/environment.py +++ b/bust/jinja_utils/environment.py @@ -10,14 +10,17 @@ from bust._version import __VERSION__ -def generated_by() -> str: - """The first line of every generated file: the bust version and the time. - - SOURCE_DATE_EPOCH, if set, gives the time, for reproducible output. - """ +def generated_at() -> str: + """The time of the run. SOURCE_DATE_EPOCH, if set, gives the time, for + reproducible output.""" epoch = os.environ.get("SOURCE_DATE_EPOCH") when = datetime.fromtimestamp(int(epoch), timezone.utc) if epoch else datetime.now() - return f"Generated by bust v{__VERSION__} {when:%Y-%m-%d %H:%M}" + return f"{when:%Y-%m-%d %H:%M}" + + +def generated_by() -> str: + """The first line of every generated file: the bust version and the time.""" + return f"Generated by bust v{__VERSION__} {generated_at()}" def get_environment(additional_filters=None): @@ -31,7 +34,7 @@ def get_environment(additional_filters=None): Environment: Configured Jinja2 environment with: - Template directory set to bust/templates - trim_blocks=True and lstrip_blocks=True for clean output - - Common filters registered (hex_format, utf8tolatex, indent_all) + - Common filters registered (hex_format, utf8tolatex, utf8tohtml, indent_all) - Additional filters if provided """ # Get template directory relative to this module @@ -45,14 +48,22 @@ def get_environment(additional_filters=None): ) # Register common filters used across modules - from bust.jinja_utils.filters import align, to_binary, utf8tolatex, wrap + from bust.jinja_utils.filters import ( + align, + to_binary, + utf8tohtml, + utf8tolatex, + wrap, + ) env.filters["align"] = align env.filters["to_binary"] = to_binary env.filters["utf8tolatex"] = utf8tolatex + env.filters["utf8tohtml"] = utf8tohtml env.filters["wrap"] = wrap env.globals["generated_by"] = generated_by + env.globals["generated_at"] = generated_at # Register any additional filters provided if additional_filters: diff --git a/bust/jinja_utils/filters.py b/bust/jinja_utils/filters.py index 43920c7d..0d904142 100644 --- a/bust/jinja_utils/filters.py +++ b/bust/jinja_utils/filters.py @@ -8,11 +8,13 @@ - align: Line up a token, such as ":" or "<=", in a column. - wrap: Break a call that is too long after a comma. - utf8tolatex: Convert UTF-8 text to LaTeX-safe encoding. +- utf8tohtml: Escape text for HTML, with `code` spans as . Copyright (c) 2025 Ola Groettvik Licensed under the Apache License, Version 2.0. See the LICENSE file for details. """ +import html import re @@ -145,3 +147,13 @@ def utf8tolatex(text): ) for i, part in enumerate(parts) ) + + +def utf8tohtml(text): + """Escape text for HTML, with a `code` span as , as utf8tolatex sets + it in typewriter type.""" + parts = re.split(r"`([^`]*)`", str(text)) + return "".join( + html.escape(part) if i % 2 == 0 else "" + html.escape(part) + "" + for i, part in enumerate(parts) + ) diff --git a/bust/templates/html/documentation.j2 b/bust/templates/html/documentation.j2 new file mode 100644 index 00000000..338b0ee2 --- /dev/null +++ b/bust/templates/html/documentation.j2 @@ -0,0 +1,112 @@ + + + + + + +{{ module.name | e }} + + + + +
+
Generated by bust v{{ version }}{% if module.version %}Version: {{ module.version | e }}{% endif %}
+
+

{{ module.name | e }}

+{% if module.version %} +

Version: {{ module.version | e }}

+{% endif %} +

Register map hash: 0x{{ module.regmap_hash_hex }}

+

{{ generated_at() }}

+
+{% if module.description %} +

{{ module.description | utf8tohtml }}

+{% endif %} + +

1 Register List

+ + +{% for header in list_headers %}{% endfor %} + + +{% for row, reg in list_rows %} + +{% endfor %} + +
{{ header | e }}
{{ row[0] }}{{ row[1] | e }}{{ row[2] }}{{ row[3] }}{{ row[4] }}{{ row[5] }}{{ row[6] }}
+ +

2 Registers

+{% for reg in module.registers %} +{% set title, address = register_heading(reg) %} +
+

{{ title | e }}{{ address }}

+{% if reg.description %} +

{{ reg.description | utf8tohtml }}

+{% endif %} +
{{ bit_diagram_svg(reg, module.data_width) }}
+{% if reg.type == reg_type_fields %} +
+{% for name, note in field_notes(reg) %} +
{{ name | e }}
{{ note | utf8tohtml }}
+{% endfor %} +
+{% endif %} +

Back to the register list

+
+{% endfor %} +
+ + diff --git a/docs/command-line.md b/docs/command-line.md index 7747e730..72bd6a5e 100644 --- a/docs/command-line.md +++ b/docs/command-line.md @@ -38,8 +38,8 @@ and exit with status 1. |----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `-o DIR` | Write the output under `DIR` instead of next to the JSON file. See [Output directory](#output-directory). | | `-f` | Overwrite existing files without asking, except `.vhd`, which is yours. See [Existing files](#existing-files). | -| `-d` | Do not write the documentation, neither the `.tex` file nor the PDF. | -| `-p` | Write the `.tex` file, but do not run `pdflatex` to make the PDF. | +| `-d` | Do not write the documentation: no `.tex` or `.html` file and no PDF. | +| `-p` | Write the `.tex` and `.html` files, but do not run `pdflatex` to make the PDF, even when it is installed. | | `-i` | Do not write the headers: the `.h`, `.hpp` and `.py` files, and for IPBus the `.xml` address table. | | `--replace-top` | Replace `.vhd` with a fresh starter and keep the old file as `.vhd.bak`. Asks first unless you add `-f`. See [Your top level](#your-top-level). | | `-a` | Give every register a new address and save the JSON file. Generates nothing. With `-f`, saves without asking. See [Renumber addresses](#renumber-addresses). | @@ -68,6 +68,7 @@ out/ └── example_ipbus/ ├── doc/ │ ├── example_ipbus.aux + │ ├── example_ipbus.html │ ├── example_ipbus.log │ ├── example_ipbus.pdf │ └── example_ipbus.tex @@ -91,7 +92,7 @@ out/ | `hdl/` | `_localbus_pkg.vhd`, `_regfile_pkg.vhd`, `_regfile.vhd`, the endpoint, `.vhd` | [Generated HDL](generated-hdl.md) | | `tb/` | `_tb.vhd` | [Testbenches](testbenches.md) | | `header/` | `.h`, `.hpp`, `.py`, and `.xml` for IPBus | [Headers and documentation](headers-and-docs.md) | -| `doc/` | `.tex`, `.pdf`, and the `.aux` and `.log` files from `pdflatex` | [Headers and documentation](headers-and-docs.md) | +| `doc/` | `.tex`, `.html`, and with `pdflatex` installed `.pdf` and its `.aux` and `.log` files | [Headers and documentation](headers-and-docs.md) | The endpoint file is named after the bus: @@ -380,10 +381,10 @@ Generating Module Documentation... Generating Documentation PDF... ``` -When `pdflatex` is not on your `PATH`, the last line is followed by: +When `pdflatex` is not on your `PATH`, the last line is instead: ```text -Could not run pdflatex ([Errno 2] No such file or directory: 'pdflatex'). Use -p to skip the PDF. +pdflatex is not on PATH, so bust skipped the PDF. The documentation is in /path/to/out/example_axi/doc/example_axi.html. ``` When `pdflatex` runs but reports errors, bust prints diff --git a/docs/getting-started.md b/docs/getting-started.md index 76e4f037..5f75ba88 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -86,6 +86,7 @@ bust writes one directory per module: ```text out/timer/ ├── doc/ +│ ├── timer.html │ ├── timer.pdf │ └── timer.tex ├── hdl/ @@ -102,7 +103,7 @@ out/timer/ └── timer_tb.vhd ``` -The PDF needs `pdflatex` on your `PATH`. Add `-p` to skip it. +`timer.html` is the documentation of the register map. Open it in a browser. bust writes `timer.pdf` only when `pdflatex` is on your `PATH`, and `-p` skips it. [Command line](command-line.md) describes every option. ## Use the VHDL diff --git a/docs/headers-and-docs.md b/docs/headers-and-docs.md index f7e93ccf..a2724ee8 100644 --- a/docs/headers-and-docs.md +++ b/docs/headers-and-docs.md @@ -1,9 +1,7 @@ # Headers and documentation Next to the VHDL, bust writes headers that give software the addresses and bit -positions of the registers, an address table for IPBus, and a LaTeX document -of the register map. This page describes what each file holds and how to use -it. +positions of the registers, an address table for IPBus, and documentation of the register map as LaTeX, HTML and, when `pdflatex` is installed, PDF. This page describes what each file holds and how to use it. ## Files @@ -18,7 +16,8 @@ output directory of the module described in | `.py` | Python module with constants in a class | Unless you give `-i` | | `.xml` | IPBus address table for uHAL | For the `ipbus` bus type, unless you give `-i` | | `.tex` | LaTeX source of the documentation | Unless you give `-d` | -| `.pdf` | The documentation as PDF | Unless you give `-d` or `-p`. Needs `pdflatex`. | +| `.html`| The documentation as one HTML page | Unless you give `-d` | +| `.pdf` | The documentation as PDF | Unless you give `-d` or `-p`, when `pdflatex` is on your `PATH` | ## Constant names @@ -264,11 +263,11 @@ module: ## Documentation -`doc/.tex` is a LaTeX document of the register map. It contains: +bust writes the documentation of the register map twice, as `doc/.tex` and as `doc/.html`, with the same content and layout. Neither needs anything beyond bust itself. Both contain: - A title with the module name, the `version` of the module, the hash of the register map, and the date and - time the PDF was built. Each page has `Generated by bust` and the bust + time of the run (for the PDF, the time it was built). Each page has `Generated by bust` and the bust version at the top. - The `description` of the module. - **Register List**, a table of every register with its number, name, software @@ -280,8 +279,7 @@ module: and its `onread`, `onwrite`, `singlepulse` and enumeration values where it has them. -In descriptions, a `` `code` `` span is set in typewriter type, and a character -that LaTeX cannot print, such as an emoji, is left out. +In descriptions, a `` `code` `` span is set in typewriter type. In the LaTeX document, a character that LaTeX cannot print, such as an emoji, is left out. This is the section for `reg11` from `prototype.tex`: @@ -297,9 +295,13 @@ This is the section for `reg11` from `prototype.tex`: \end{register} ``` +### The HTML page + +`doc/.html` is one self-contained file: the styles are in the page and the bit diagrams are inline SVG, so it opens in any browser and can be copied or served on its own. On top of the layout of the LaTeX document it adds links: each row of the register list links to the section of its register, a sidebar lists every register, and each section links back to the register list. The page has a print stylesheet that hides the sidebar and the links back, so printing it to PDF from a browser gives a clean document without `pdflatex`. + ### The PDF -After writing the `.tex` file, bust runs `pdflatex` once to make the PDF: +When `pdflatex` is on your `PATH`, bust runs it once on the `.tex` file to make the PDF: ```bash pdflatex --interaction=batchmode --output-directory= /.tex @@ -312,6 +314,8 @@ and `listings`. On Debian and Ubuntu, the packages `texlive-latex-base`, `pdflatex` writes `.pdf` to `doc/`, together with its `.aux` and `.log` files. +When `pdflatex` is not on your `PATH`, bust writes the `.tex` and `.html` files, prints `pdflatex is not on PATH, so bust skipped the PDF.` followed by the path of the HTML page, and exits with status 0. + bust runs `pdflatex` in batch mode and does not show its output. When `pdflatex` reports errors, bust prints `pdflatex reported errors. See /.log`. When it cannot run `pdflatex` at all, it prints @@ -319,5 +323,5 @@ bust runs `pdflatex` in batch mode and does not show its output. When carries on: the other files are written and bust exits with status 0. To build the PDF in your own flow instead, give `-p`. bust then writes the -`.tex` file but does not run `pdflatex`. Give `-d` to skip the documentation +`.tex` and `.html` files but does not run `pdflatex`. Give `-d` to skip the documentation altogether. diff --git a/docs/index.md b/docs/index.md index bfd74e11..e231a480 100644 --- a/docs/index.md +++ b/docs/index.md @@ -8,7 +8,7 @@ **bust** generates the register file of an FPGA or ASIC module from a JSON register map. From one file it writes the VHDL register file with its bus endpoint, a self-checking UVVM testbench, C, C++ and Python headers, an IPBus -address table and LaTeX documentation. +address table and documentation as HTML, LaTeX and PDF. bust supports six buses: AXI4-Lite, IPBus, SBI, Avalon-MM, Wishbone and APB. @@ -53,7 +53,7 @@ testbench of every bus in CI. - [Generated HDL](generated-hdl.md): the generated files, the records and how to instantiate the module. - [Headers and documentation](headers-and-docs.md): the C, C++ and Python - headers, the IPBus address table and the LaTeX documentation. + headers, the IPBus address table and the documentation. - [Testbenches](testbenches.md): what the testbench checks and how to run it. - [Command line](command-line.md): every option of the `bust` command. diff --git a/docs/register-map-format.md b/docs/register-map-format.md index 676b4813..68ecb39c 100644 --- a/docs/register-map-format.md +++ b/docs/register-map-format.md @@ -174,7 +174,7 @@ the timing of each protocol. | `name` | string | required | Module name. It names the generated files and VHDL units, such as `uart_regfile` and `uart_regfile_pkg`. See [Names](#names). | | `register` | list | required | The registers, see [Registers](#registers). | | `version` | string | `""` | The version of the register map. Every generated file carries it, see [Version and hash](#version-and-hash). Printable ASCII characters other than `"`, `\`, `;` and `=`. A module with a `version` register needs the form `MAJOR.MINOR` or `MAJOR.MINOR.PATCH`. | -| `description` | string | `""` | Shown in the LaTeX documentation. | +| `description` | string | `""` | Shown in the documentation. | | `byte_addressable` | boolean | from the bus | `true` if an address counts bytes, `false` if it counts data words. See [Byte and word addresses](#byte-and-word-addresses). | ### Version and hash @@ -201,7 +201,7 @@ Both appear in every output: | C header | `_REGMAP_VERSION` | `_REGMAP_HASH` | | C++ and Python headers | `REGMAP_VERSION` | `REGMAP_HASH` | | IPBus address table | `regmap_version=` in the `parameters` of the top node | `regmap_hash=` in the same `parameters` | -| LaTeX documentation | Title page and page footer | Title page, under the version | +| Documentation | Title and page footer (HTML: running header) | Title, under the version | ### Hash and version registers @@ -269,7 +269,7 @@ Each entry in `register` is one register. | `address` | [number](#numbers) | next free address | Register offset. See [Addresses](#addresses). | | `width` | [number](#numbers) | `data_width` | Width of a `vector` register. | | `reset` | [number](#numbers) | `0` | Reset value of a register without fields. See [Reset values](#reset-values). | -| `description` | string | `""` | Shown in the LaTeX documentation and the IPBus address table. | +| `description` | string | `""` | Shown in the documentation and the IPBus address table. | | `fields` | list | none | The fields of a `fields` register. See [Fields](#fields). | | access keys | | | Defaults for the register's fields. See [Access keys](#access-keys). | @@ -438,7 +438,7 @@ A `fields` register lists its fields under `fields`. Each entry is one field. | `width` | [number](#numbers) | `1` | Width of a `vector` field. A `bit` field is always 1 bit wide, and bust ignores a different `width` with a warning. | | `position` | [number](#numbers) | next free bit | Lowest bit of the field. See [Bit positions](#bit-positions). | | `reset` | [number](#numbers) | `0` | Reset value of the field. | -| `description` | string | `""` | Shown in the LaTeX documentation and the IPBus address table. | +| `description` | string | `""` | Shown in the documentation and the IPBus address table. | | `enums` | list | none | Named values. See [Enumerations](#enumerations). | | access keys | | from the register | See [Access keys](#access-keys). | diff --git a/example/example_axi/doc/example_axi.html b/example/example_axi/doc/example_axi.html new file mode 100644 index 00000000..b8466d6b --- /dev/null +++ b/example/example_axi/doc/example_axi.html @@ -0,0 +1,212 @@ + + + + + + +example_axi + + + + +
+
Generated by bust v1.0.0-devVersion: 1.0
+
+

example_axi

+

Version: 1.0

+

Register map hash: 0x0CF519FC

+

1970-01-01 00:00

+
+

An example module that contain all the register types that are currently supported by bust.

+ +

1 Register List

+ + + + + + + + + + + + + + + + + + + + +
#NameSW/HWAddressTypeWidthReset
0reg0RW/R0x00000000BIT10x0
1reg1RW/R0x00000004BIT10x1
2reg2RO/W0x00000008BIT10x0
3reg3RW/R0x0000000CVECTOR80x3
4reg4RO/W0x00000010VECTOR140x0
5reg5RW/R0x00000014DEFAULT320xFFFFFFFF
6reg6RO/W0x00000018DEFAULT320x0
7reg7RW/R0x0000001CFIELDS210xAD7
8reg8RO/W0x00000020FIELDS240x0
9reg9WO/R0x00000024BIT10x1
10reg10WO/R0x00000028VECTOR40xA
11reg11WO/R0x0000002CFIELDS160x3
12regmap_hashRO/NA0x00000030HASH320xCF519FC
13regmap_versionRO/NA0x00000034VERSION320x10000
+ +

2 Registers

+
+

reg0 - RW/R0x00000000

+

RW std_logic register that resets to 0x0

+
311unused-0reg00
+

Back to the register list

+
+
+

reg1 - RW/R0x00000004

+

RW std_logic register that resets to 0x1

+
311unused-0reg11
+

Back to the register list

+
+
+

reg2 - RO/W0x00000008

+

RO std_logic register

+
311unused-0reg20
+

Back to the register list

+
+
+

reg3 - RW/R0x0000000C

+

RW std_logic_vector[7:0] register that resets to 0x3

+
318unused-70reg30x3
+

Back to the register list

+
+
+

reg4 - RO/W0x00000010

+

RO std_logic_vector[13:0]

+
3114unused-130reg40x0
+

Back to the register list

+
+
+

reg5 - RW/R0x00000014

+

Default RW register that resets to 0xFFFFFFFF

+
310reg50xFFFFFFFF
+

Back to the register list

+
+
+

reg6 - RO/W0x00000018

+

Default RO register

+
310reg60x0
+

Back to the register list

+
+
+

reg7 - RW/R0x0000001C

+

RW register that have multiple fields

+
3121unused-206field30x2B5field2041field10xB0field01
+
+
field0
std_logic that resets to 0x1 (sw: rw, hw: r)
+
field1
std_logic_vector[3:0] that resets to 0xb is not a valid reset value (sw: rw, hw: r)
+
field2
std_logic that resets to 0x1 (sw: rw, hw: r)
+
field3
std_logic_vector[14:0] that resets to 0x2b (sw: rw, hw: r)
+
+

Back to the register list

+
+
+

reg8 - RO/W0x00000020

+

RO register with multiple types of fields

+
3124unused-2321field30x020field20191field10x00field00
+
+
field0
std_logic field (sw: ro, hw: w)
+
field1
std_logic_vector[18:0] field (sw: ro, hw: w)
+
field2
std_logic field (sw: ro, hw: w)
+
field3
std_logic_vector[2:0] field (sw: ro, hw: w)
+
+

Back to the register list

+
+
+

reg9 - WO/R0x00000024

+

PULSE std_logic register that resets to 0x1

+
311unused-0reg91
+

Back to the register list

+
+
+

reg10 - WO/R0x00000028

+

PULSE std_logic_vector[3:0] register that resets to 0xA

+
314unused-30reg100xA
+

Back to the register list

+
+
+

reg11 - WO/R0x0000002C

+

PULSE register with two fields

+
3116unused-15field10140field00x3
+
+
field0
std_logic_vector[14:0] field that resets to 0x3 (sw: wo, hw: r, singlepulse)
+
field1
std_logic field that resets to 0x0 (sw: wo, hw: r, singlepulse)
+
+

Back to the register list

+
+
+

regmap_hash - RO/NA0x00000030

+

Hash of the register map, to compare with EXAMPLE_AXI_REGMAP_HASH in the header

+
310regmap_hash0xCF519FC
+

Back to the register list

+
+
+

regmap_version - RO/NA0x00000034

+

Version of the register map, 1.0 as 0x00010000

+
310regmap_version0x10000
+

Back to the register list

+
+
+ + diff --git a/example/example_ipbus/doc/example_ipbus.html b/example/example_ipbus/doc/example_ipbus.html new file mode 100644 index 00000000..392fe700 --- /dev/null +++ b/example/example_ipbus/doc/example_ipbus.html @@ -0,0 +1,196 @@ + + + + + + +example_ipbus + + + + +
+
Generated by bust v1.0.0-devVersion: 1.0
+
+

example_ipbus

+

Version: 1.0

+

Register map hash: 0xFCD085B6

+

1970-01-01 00:00

+
+

An example module that contain all the register types that are currently supported by bust.

+ +

1 Register List

+ + + + + + + + + + + + + + + + + + +
#NameSW/HWAddressTypeWidthReset
0reg0RW/R0x00000000BIT10x0
1reg1RW/R0x00000004BIT10x1
2reg2RO/W0x00000008BIT10x0
3reg3RW/R0x0000000CVECTOR80x3
4reg4RO/W0x00000010VECTOR140x0
5reg5RW/R0x00000014DEFAULT320xFFFFFFFF
6reg6RO/W0x00000018DEFAULT320x0
7reg7RW/R0x0000001CFIELDS210xAD7
8reg8RO/W0x00000020FIELDS240x0
9reg9WO/R0x00000024BIT10x1
10reg10WO/R0x00000028VECTOR40xA
11reg11WO/R0x0000002CFIELDS160x3
+ +

2 Registers

+
+

reg0 - RW/R0x00000000

+

RW std_logic register that resets to 0x0

+
311unused-0reg00
+

Back to the register list

+
+
+

reg1 - RW/R0x00000004

+

RW std_logic register that resets to 0x1

+
311unused-0reg11
+

Back to the register list

+
+
+

reg2 - RO/W0x00000008

+

RO std_logic register

+
311unused-0reg20
+

Back to the register list

+
+
+

reg3 - RW/R0x0000000C

+

RW std_logic_vector[7:0] register that resets to 0x3

+
318unused-70reg30x3
+

Back to the register list

+
+
+

reg4 - RO/W0x00000010

+

RO std_logic_vector[13:0]

+
3114unused-130reg40x0
+

Back to the register list

+
+
+

reg5 - RW/R0x00000014

+

Default RW register that resets to 0xFFFFFFFF

+
310reg50xFFFFFFFF
+

Back to the register list

+
+
+

reg6 - RO/W0x00000018

+

Default RO register

+
310reg60x0
+

Back to the register list

+
+
+

reg7 - RW/R0x0000001C

+

RW register that have multiple fields

+
3121unused-206field30x2B5field2041field10xB0field01
+
+
field0
std_logic that resets to 0x1 (sw: rw, hw: r)
+
field1
std_logic_vector[3:0] that resets to 0xb is not a valid reset value (sw: rw, hw: r)
+
field2
std_logic that resets to 0x1 (sw: rw, hw: r)
+
field3
std_logic_vector[14:0] that resets to 0x2b (sw: rw, hw: r)
+
+

Back to the register list

+
+
+

reg8 - RO/W0x00000020

+

RO register with multiple types of fields

+
3124unused-2321field30x020field20191field10x00field00
+
+
field0
std_logic field (sw: ro, hw: w)
+
field1
std_logic_vector[18:0] field (sw: ro, hw: w)
+
field2
std_logic field (sw: ro, hw: w)
+
field3
std_logic_vector[2:0] field (sw: ro, hw: w)
+
+

Back to the register list

+
+
+

reg9 - WO/R0x00000024

+

PULSE std_logic register that resets to 0x1

+
311unused-0reg91
+

Back to the register list

+
+
+

reg10 - WO/R0x00000028

+

PULSE std_logic_vector[3:0] register that resets to 0xA

+
314unused-30reg100xA
+

Back to the register list

+
+
+

reg11 - WO/R0x0000002C

+

PULSE register with two fields

+
3116unused-15field10140field00x3
+
+
field0
std_logic_vector[14:0] field that resets to 0x3 (sw: wo, hw: r, singlepulse)
+
field1
std_logic field that resets to 0x0 (sw: wo, hw: r, singlepulse)
+
+

Back to the register list

+
+
+ + diff --git a/example/example_prototype/doc/prototype.html b/example/example_prototype/doc/prototype.html new file mode 100644 index 00000000..6b26460f --- /dev/null +++ b/example/example_prototype/doc/prototype.html @@ -0,0 +1,227 @@ + + + + + + +prototype + + + + +
+
Generated by bust v1.0.0-devVersion: 1.0
+
+

prototype

+

Version: 1.0

+

Register map hash: 0x593FA68E

+

1970-01-01 00:00

+
+

Comprehensive example exercising every v1 access mode, mirroring the prototype demo module (reg0..reg11).

+ +

1 Register List

+ + + + + + + + + + + + + + + + + + +
#NameSW/HWAddressTypeWidthReset
0reg0RW/R0x00000000FIELDS30x0
1reg1RO/W0x00000004FIELDS60x0
2reg2WO/R0x00000008FIELDS10x0
3reg3RW/NA0x0000000CFIELDS80x0
4reg4RW/RW0x00000010FIELDS90x0
5reg5RW/R0x00000014FIELDS80x0
6reg6RW/R0x00000018FIELDS120xF0
7reg7RW/R0x0000001CFIELDS120xF0
8reg8RW/R0x00000020FIELDS80xF
9reg9RW/R0x00000024FIELDS80x0
10reg10RW/R0x00000028FIELDS40x0
11reg11RW/R0x0000002CFIELDS20x0
+ +

2 Registers

+
+

reg0 - RW/R0x00000000

+

Plain rw storage, hardware reads back.

+
313unused-21field10x00field00
+
+
field0
(sw: rw, hw: r)
+
field1
(sw: rw, hw: r)
+
+

Back to the register list

+
+
+

reg1 - RO/W0x00000004

+

Hardware-driven status, software read-only.

+
316unused-5field204field1030field00x0
+
+
field0
(sw: ro, hw: w)
+
field1
(sw: ro, hw: w)
+
field2
(sw: ro, hw: w)
+
+

Back to the register list

+
+
+

reg2 - WO/R0x00000008

+

Write-only command field.

+
311unused-0field00
+
+
field0
(sw: wo, hw: r)
+
+

Back to the register list

+
+
+

reg3 - RW/NA0x0000000C

+

Software-only scratch register.

+
318unused-70field00x0
+
+
field0
(sw: rw, hw: na)
+
+

Back to the register list

+
+
+

reg4 - RW/RW0x00000010

+

Hardware write-enable and hardware set/clear.

+
319unused-8field1074unused-30field00x0
+
+
field0
(sw: rw, hw: rw)
+
field1
(sw: rw, hw: r)
+
+

Back to the register list

+
+
+

reg5 - RW/R0x00000014

+

Read side effects.

+
318unused-74field10x030field00x0
+
+
field0
(sw: rw, hw: r, onread: rclr)
+
field1
(sw: rw, hw: r, onread: rset)
+
+

Back to the register list

+
+
+

reg6 - RW/R0x00000018

+

Write-1 onwrite effects.

+
3112unused-118field20x074field10xF30field00x0
+
+
field0
(sw: rw, hw: r, onwrite: woset)
+
field1
(sw: rw, hw: r, onwrite: woclr)
+
field2
(sw: rw, hw: r, onwrite: wot)
+
+

Back to the register list

+
+
+

reg7 - RW/R0x0000001C

+

Write-0 onwrite effects.

+
3112unused-118field20x074field10xF30field00x0
+
+
field0
(sw: rw, hw: r, onwrite: wzs)
+
field1
(sw: rw, hw: r, onwrite: wzc)
+
field2
(sw: rw, hw: r, onwrite: wzt)
+
+

Back to the register list

+
+
+

reg8 - RW/R0x00000020

+

Whole-field onwrite effects.

+
318unused-74field10x030field00xF
+
+
field0
(sw: rw, hw: r, onwrite: wclr)
+
field1
(sw: rw, hw: r, onwrite: wset)
+
+

Back to the register list

+
+
+

reg9 - RW/R0x00000024

+

Software-access pulses.

+
318unused-74field10x030field00x0
+
+
field0
(sw: rw, hw: r)
+
field1
(sw: rw, hw: r)
+
+

Back to the register list

+
+
+

reg10 - RW/R0x00000028

+

Single-cycle pulse on software write.

+
314unused-30field00x0
+
+
field0
(sw: rw, hw: r, singlepulse)
+
+

Back to the register list

+
+
+

reg11 - RW/R0x0000002C

+

Enumerated field.

+
312unused-10field00x0
+
+
field0
(sw: rw, hw: r; values: STATE0=0, STATE1=1, STATE2=2, STATE3=3)
+
+

Back to the register list

+
+
+ + diff --git a/scripts/smoke-test.sh b/scripts/smoke-test.sh index f5609339..179244ea 100755 --- a/scripts/smoke-test.sh +++ b/scripts/smoke-test.sh @@ -9,6 +9,8 @@ examples="$(cd "$(dirname "$0")/../example" && pwd)" output_dir="$(mktemp -d)" # bust writes debug.log to the working directory. cd "$output_dir" +# The HTML documentation shows the time of the run, which the goldens pin to 0. +export SOURCE_DATE_EPOCH=0 bust --version | grep -Fx "bust v$expected_version" for example in example_axi example_ipbus; do diff --git a/tests/test_generation.py b/tests/test_generation.py index 52aacce2..7200b10b 100644 --- a/tests/test_generation.py +++ b/tests/test_generation.py @@ -1,6 +1,6 @@ """.vhd belongs to the user. bust writes a starter only when the file is missing, does not replace it with -f, and replaces it with --replace-top, keeping -the old file.""" +the old file. The documentation needs no pdflatex.""" import logging import os @@ -30,7 +30,7 @@ def _write_top(out_dir, text): return top -def _generate(out_dir, force_ow=True, replace_top=False): +def _generate(out_dir, force_ow=True, replace_top=False, gen_doc=False): cfg = json_parser(_EXAMPLE_JSON) settings = Settings(_EXAMPLE_JSON) bus = Bus(cfg["bus"]) @@ -38,8 +38,8 @@ def _generate(out_dir, force_ow=True, replace_top=False): "dir": str(out_dir), "force_ow": force_ow, "replace_top": replace_top, - "gen_doc": False, - "gen_pdf": False, + "gen_doc": gen_doc, + "gen_pdf": gen_doc, "gen_header": False, "gen_localbus": True, } @@ -102,3 +102,15 @@ def test_replace_top_without_a_terminal_asks_for_force(tmp_path, monkeypatch): assert _read(top) == "-- my own top level\n" assert not os.path.exists(top + ".bak") + + +def test_docs_without_pdflatex_skip_only_the_pdf(tmp_path, monkeypatch, caplog): + pytest.importorskip("pylatexenc") + monkeypatch.setenv("PATH", str(tmp_path / "empty")) + + with caplog.at_level(logging.INFO): + _generate(tmp_path, gen_doc=True) + + doc_dir = os.path.join(str(tmp_path), "example_axi", "doc") + assert sorted(os.listdir(doc_dir)) == ["example_axi.html", "example_axi.tex"] + assert "pdflatex is not on PATH, so bust skipped the PDF" in caplog.text diff --git a/tests/test_latex.py b/tests/test_latex.py index 95ab94f6..4b319631 100644 --- a/tests/test_latex.py +++ b/tests/test_latex.py @@ -1,4 +1,4 @@ -"""Descriptions in the LaTeX documentation.""" +"""Descriptions in the LaTeX and HTML documentation.""" import pytest @@ -10,3 +10,11 @@ def test_description_code_and_unknown_characters(): assert utf8tolatex("⚠️ Write `ctrl_reg` & 50% é") == ( r" Write \texttt{ctrl{\_}reg} {\&} 50{\%} {\'e}" ) + + +def test_html_description_escapes_and_keeps_code(): + from bust.jinja_utils.filters import utf8tohtml + + assert utf8tohtml("⚠️ Write `a") == ( + "⚠️ Write a<b & <i>" + ) diff --git a/tests/test_suite.py b/tests/test_suite.py index a852ca51..c1025203 100644 --- a/tests/test_suite.py +++ b/tests/test_suite.py @@ -173,13 +173,17 @@ def test_doc(self): for holder in self.buzz: with self.subTest(holder=holder): self.logger.info("Testing Doc generation...") + base = "example/example_{0}/doc/example_{0}".format(holder.bus.bus_type) self._assert_matches( holder.doc.generate_tex_documentation("1.0.0-dev"), - "example/example_{0}/doc/example_{0}.tex".format( - holder.bus.bus_type - ), + base + ".tex", "doc must match manual file", ) + self._assert_matches( + holder.doc.generate_html_documentation("1.0.0-dev"), + base + ".html", + "html doc must match manual file", + ) ############## Prototype (full access-mode coverage) ################## @@ -342,6 +346,11 @@ def test_prototype_doc(self): "example/example_prototype/doc/prototype.tex", "prototype doc must match manual file", ) + self._assert_matches( + doc.generate_html_documentation("1.0.0-dev"), + "example/example_prototype/doc/prototype.html", + "prototype html doc must match manual file", + ) ############## Access-mode combination matrix ################## From 488ce5e227ffefd34863557dd498b476cd275b54 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ola=20Gr=C3=B8ttvik?= Date: Tue, 27 Oct 2026 13:30:45 +0000 Subject: [PATCH 2/8] Show the prototype HTML documentation in the Sphinx docs --- bust/templates/html/documentation.j2 | 8 +++++-- docs/_static/custom.css | 11 +++++++++ docs/conf.py | 24 ++++++++++++++++++++ docs/headers-and-docs.md | 4 ++++ example/example_axi/doc/example_axi.html | 8 +++++-- example/example_ipbus/doc/example_ipbus.html | 8 +++++-- example/example_prototype/doc/prototype.html | 8 +++++-- 7 files changed, 63 insertions(+), 8 deletions(-) diff --git a/bust/templates/html/documentation.j2 b/bust/templates/html/documentation.j2 index 338b0ee2..6ca4879b 100644 --- a/bust/templates/html/documentation.j2 +++ b/bust/templates/html/documentation.j2 @@ -16,7 +16,7 @@ nav { position: fixed; top: 0; bottom: 0; left: 0; width: 13rem; overflow-y: aut nav h2 { font-size: 0.95rem; margin: 0 0 0.5rem; } nav ol { list-style: none; margin: 0; padding: 0; } nav li { margin: 0.15rem 0; } -main { margin-left: 13rem; padding: 1.5rem 2.5rem 4rem; max-width: 62rem; } +main { margin-left: 13rem; padding: 1.5rem 2rem 4rem; max-width: 62rem; } .running { display: flex; justify-content: space-between; color: var(--muted); font-size: 0.85rem; border-bottom: 1px solid var(--rule); padding-bottom: 0.3rem; } header.title { text-align: center; margin: 2.5rem 0 2rem; } header.title h1 { font-size: 2rem; font-weight: normal; margin: 0 0 0.8rem; } @@ -27,6 +27,7 @@ table.list th, table.list td { border: 1px solid var(--ink); padding: 0.15rem 0. table.list td.num { text-align: center; } section.register { margin: 0 0 2.5rem; break-inside: avoid; } section.register h3 { display: flex; justify-content: space-between; font-size: 1.05rem; margin: 0 0 0.4rem; } +.scroll { overflow-x: auto; } .diagram { overflow-x: auto; margin: 0.6rem 0; } svg.bits { width: 100%; height: auto; } svg.bits rect.field { fill: #fff; stroke: var(--ink); } @@ -39,8 +40,9 @@ dl.fields { margin: 0.5rem 0 0 1.5rem; } dl.fields dt { font-weight: bold; float: left; clear: left; margin-right: 0.6rem; } dl.fields dd { margin: 0 0 0.3rem; } .back { font-size: 0.85rem; } -@media (max-width: 50rem) { +@media (max-width: 40rem) { nav { position: static; width: auto; border-right: none; border-bottom: 1px solid var(--rule); } + nav ol { display: flex; flex-wrap: wrap; gap: 0 0.9rem; } main { margin-left: 0; padding: 1rem; } } @media print { @@ -77,6 +79,7 @@ dl.fields dd { margin: 0 0 0.3rem; } {% endif %}

1 Register List

+
{% for header in list_headers %}{% endfor %} @@ -87,6 +90,7 @@ dl.fields dd { margin: 0 0 0.3rem; } {% endfor %}
{{ header | e }}
+

2 Registers

{% for reg in module.registers %} diff --git a/docs/_static/custom.css b/docs/_static/custom.css index f3009dd2..f4576e9b 100644 --- a/docs/_static/custom.css +++ b/docs/_static/custom.css @@ -72,3 +72,14 @@ section#bust > h1 { .addr-fig .row { font-weight: 700; } + +/* The example HTML documentation on the Headers and documentation page. The + page keeps its own white background in both modes, as it would on its own. */ +.doc-example { + display: block; + width: 100%; + height: 36rem; + margin: 1.5rem 0; + border: 1px solid var(--color-background-border); + background: #fff; +} diff --git a/docs/conf.py b/docs/conf.py index 46d6b0a2..a07a3023 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -1,4 +1,7 @@ # SPDX-License-Identifier: Apache-2.0 +import os +import shutil + from bust._version import __VERSION__ project = "bust" @@ -55,3 +58,24 @@ "color-highlighted-background": "#2f2c2a", }, } + + +# The documentation bust generated for the prototype example, copied into the +# built site so the docs can show it. The copies come from the committed +# goldens, which the tests keep in step with the generator. +_EXAMPLE_DOCS = [ + os.path.join("..", "example", "example_prototype", "doc", "prototype.html"), +] + + +def _copy_example_docs(app, exception): + if exception is not None or app.builder.format != "html": + return + examples_dir = os.path.join(app.outdir, "examples") + os.makedirs(examples_dir, exist_ok=True) + for path in _EXAMPLE_DOCS: + shutil.copy(os.path.join(app.confdir, path), examples_dir) + + +def setup(app): + app.connect("build-finished", _copy_example_docs) diff --git a/docs/headers-and-docs.md b/docs/headers-and-docs.md index a2724ee8..b91e32d9 100644 --- a/docs/headers-and-docs.md +++ b/docs/headers-and-docs.md @@ -299,6 +299,10 @@ This is the section for `reg11` from `prototype.tex`: `doc/.html` is one self-contained file: the styles are in the page and the bit diagrams are inline SVG, so it opens in any browser and can be copied or served on its own. On top of the layout of the LaTeX document it adds links: each row of the register list links to the section of its register, a sidebar lists every register, and each section links back to the register list. The page has a print stylesheet that hides the sidebar and the links back, so printing it to PDF from a browser gives a clean document without `pdflatex`. +This is the page bust writes for the prototype example, `example/example_prototype.json` in the repository. Open it on its own to try the links and the print layout. + + + ### The PDF When `pdflatex` is on your `PATH`, bust runs it once on the `.tex` file to make the PDF: diff --git a/example/example_axi/doc/example_axi.html b/example/example_axi/doc/example_axi.html index b8466d6b..009184e7 100644 --- a/example/example_axi/doc/example_axi.html +++ b/example/example_axi/doc/example_axi.html @@ -16,7 +16,7 @@ nav h2 { font-size: 0.95rem; margin: 0 0 0.5rem; } nav ol { list-style: none; margin: 0; padding: 0; } nav li { margin: 0.15rem 0; } -main { margin-left: 13rem; padding: 1.5rem 2.5rem 4rem; max-width: 62rem; } +main { margin-left: 13rem; padding: 1.5rem 2rem 4rem; max-width: 62rem; } .running { display: flex; justify-content: space-between; color: var(--muted); font-size: 0.85rem; border-bottom: 1px solid var(--rule); padding-bottom: 0.3rem; } header.title { text-align: center; margin: 2.5rem 0 2rem; } header.title h1 { font-size: 2rem; font-weight: normal; margin: 0 0 0.8rem; } @@ -27,6 +27,7 @@ table.list td.num { text-align: center; } section.register { margin: 0 0 2.5rem; break-inside: avoid; } section.register h3 { display: flex; justify-content: space-between; font-size: 1.05rem; margin: 0 0 0.4rem; } +.scroll { overflow-x: auto; } .diagram { overflow-x: auto; margin: 0.6rem 0; } svg.bits { width: 100%; height: auto; } svg.bits rect.field { fill: #fff; stroke: var(--ink); } @@ -39,8 +40,9 @@ dl.fields dt { font-weight: bold; float: left; clear: left; margin-right: 0.6rem; } dl.fields dd { margin: 0 0 0.3rem; } .back { font-size: 0.85rem; } -@media (max-width: 50rem) { +@media (max-width: 40rem) { nav { position: static; width: auto; border-right: none; border-bottom: 1px solid var(--rule); } + nav ol { display: flex; flex-wrap: wrap; gap: 0 0.9rem; } main { margin-left: 0; padding: 1rem; } } @media print { @@ -84,6 +86,7 @@

example_axi

An example module that contain all the register types that are currently supported by bust.

1 Register List

+
@@ -105,6 +108,7 @@

1 Register List

#NameSW/HWAddressTypeWidthReset
13regmap_versionRO/NA0x00000034VERSION320x10000
+

2 Registers

diff --git a/example/example_ipbus/doc/example_ipbus.html b/example/example_ipbus/doc/example_ipbus.html index 392fe700..99dcfc0d 100644 --- a/example/example_ipbus/doc/example_ipbus.html +++ b/example/example_ipbus/doc/example_ipbus.html @@ -16,7 +16,7 @@ nav h2 { font-size: 0.95rem; margin: 0 0 0.5rem; } nav ol { list-style: none; margin: 0; padding: 0; } nav li { margin: 0.15rem 0; } -main { margin-left: 13rem; padding: 1.5rem 2.5rem 4rem; max-width: 62rem; } +main { margin-left: 13rem; padding: 1.5rem 2rem 4rem; max-width: 62rem; } .running { display: flex; justify-content: space-between; color: var(--muted); font-size: 0.85rem; border-bottom: 1px solid var(--rule); padding-bottom: 0.3rem; } header.title { text-align: center; margin: 2.5rem 0 2rem; } header.title h1 { font-size: 2rem; font-weight: normal; margin: 0 0 0.8rem; } @@ -27,6 +27,7 @@ table.list td.num { text-align: center; } section.register { margin: 0 0 2.5rem; break-inside: avoid; } section.register h3 { display: flex; justify-content: space-between; font-size: 1.05rem; margin: 0 0 0.4rem; } +.scroll { overflow-x: auto; } .diagram { overflow-x: auto; margin: 0.6rem 0; } svg.bits { width: 100%; height: auto; } svg.bits rect.field { fill: #fff; stroke: var(--ink); } @@ -39,8 +40,9 @@ dl.fields dt { font-weight: bold; float: left; clear: left; margin-right: 0.6rem; } dl.fields dd { margin: 0 0 0.3rem; } .back { font-size: 0.85rem; } -@media (max-width: 50rem) { +@media (max-width: 40rem) { nav { position: static; width: auto; border-right: none; border-bottom: 1px solid var(--rule); } + nav ol { display: flex; flex-wrap: wrap; gap: 0 0.9rem; } main { margin-left: 0; padding: 1rem; } } @media print { @@ -82,6 +84,7 @@

example_ipbus

An example module that contain all the register types that are currently supported by bust.

1 Register List

+
@@ -101,6 +104,7 @@

1 Register List

#NameSW/HWAddressTypeWidthReset
11reg11WO/R0x0000002CFIELDS160x3
+

2 Registers

diff --git a/example/example_prototype/doc/prototype.html b/example/example_prototype/doc/prototype.html index 6b26460f..85c0aefe 100644 --- a/example/example_prototype/doc/prototype.html +++ b/example/example_prototype/doc/prototype.html @@ -16,7 +16,7 @@ nav h2 { font-size: 0.95rem; margin: 0 0 0.5rem; } nav ol { list-style: none; margin: 0; padding: 0; } nav li { margin: 0.15rem 0; } -main { margin-left: 13rem; padding: 1.5rem 2.5rem 4rem; max-width: 62rem; } +main { margin-left: 13rem; padding: 1.5rem 2rem 4rem; max-width: 62rem; } .running { display: flex; justify-content: space-between; color: var(--muted); font-size: 0.85rem; border-bottom: 1px solid var(--rule); padding-bottom: 0.3rem; } header.title { text-align: center; margin: 2.5rem 0 2rem; } header.title h1 { font-size: 2rem; font-weight: normal; margin: 0 0 0.8rem; } @@ -27,6 +27,7 @@ table.list td.num { text-align: center; } section.register { margin: 0 0 2.5rem; break-inside: avoid; } section.register h3 { display: flex; justify-content: space-between; font-size: 1.05rem; margin: 0 0 0.4rem; } +.scroll { overflow-x: auto; } .diagram { overflow-x: auto; margin: 0.6rem 0; } svg.bits { width: 100%; height: auto; } svg.bits rect.field { fill: #fff; stroke: var(--ink); } @@ -39,8 +40,9 @@ dl.fields dt { font-weight: bold; float: left; clear: left; margin-right: 0.6rem; } dl.fields dd { margin: 0 0 0.3rem; } .back { font-size: 0.85rem; } -@media (max-width: 50rem) { +@media (max-width: 40rem) { nav { position: static; width: auto; border-right: none; border-bottom: 1px solid var(--rule); } + nav ol { display: flex; flex-wrap: wrap; gap: 0 0.9rem; } main { margin-left: 0; padding: 1rem; } } @media print { @@ -82,6 +84,7 @@

prototype

Comprehensive example exercising every v1 access mode, mirroring the prototype demo module (reg0..reg11).

1 Register List

+
@@ -101,6 +104,7 @@

1 Register List

#NameSW/HWAddressTypeWidthReset
11reg11RW/R0x0000002CFIELDS20x0
+

2 Registers

From 1b0369fffeb51c5324f982cf0ba2e6da99754033 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ola=20Gr=C3=B8ttvik?= Date: Tue, 27 Oct 2026 13:44:56 +0000 Subject: [PATCH 3/8] Show the prototype PDF documentation in the Sphinx docs --- docs/conf.py | 8 +++++--- docs/development.md | 2 ++ docs/examples/prototype.pdf | Bin 0 -> 132569 bytes docs/headers-and-docs.md | 4 ++++ scripts/make-example-pdf.sh | 21 +++++++++++++++++++++ 5 files changed, 32 insertions(+), 3 deletions(-) create mode 100644 docs/examples/prototype.pdf create mode 100755 scripts/make-example-pdf.sh diff --git a/docs/conf.py b/docs/conf.py index a07a3023..e2a15140 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -12,7 +12,7 @@ extensions = ["myst_parser"] myst_heading_anchors = 3 -exclude_patterns = ["_build"] +exclude_patterns = ["_build", "examples"] html_theme = "furo" html_title = "bust" @@ -61,10 +61,12 @@ # The documentation bust generated for the prototype example, copied into the -# built site so the docs can show it. The copies come from the committed -# goldens, which the tests keep in step with the generator. +# built site so the docs can show it. The HTML is the committed golden, which +# the tests keep in step with the generator. Read the Docs has no pdflatex, so +# the PDF is committed too: scripts/make-example-pdf.sh rebuilds it. _EXAMPLE_DOCS = [ os.path.join("..", "example", "example_prototype", "doc", "prototype.html"), + os.path.join("examples", "prototype.pdf"), ] diff --git a/docs/development.md b/docs/development.md index 21369605..29c93efd 100644 --- a/docs/development.md +++ b/docs/development.md @@ -45,6 +45,8 @@ git diff example/ Review the diff before you commit it. It is the clearest record of what your change does to the generated code. +The documentation shows the PDF of the prototype example, which is committed as `docs/examples/prototype.pdf` because Read the Docs has no `pdflatex`. When `example/example_prototype/doc/prototype.tex` changes, rebuild the PDF with `scripts/make-example-pdf.sh`, which needs `pdflatex`. + ## Simulation `sim/` simulates the generated example testbenches, and the hand-written diff --git a/docs/examples/prototype.pdf b/docs/examples/prototype.pdf new file mode 100644 index 0000000000000000000000000000000000000000..aa3cc15990a69cd82d97d9c579d022cf9fed78a6 GIT binary patch literal 132569 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�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

9Nhtn@g(YM$6?nxS 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 YwRg4!-#2Df7A7thL<$N~Suw=_2UK781poj5 literal 0 HcmV?d00001 diff --git a/docs/headers-and-docs.md b/docs/headers-and-docs.md index b91e32d9..74cc3bf3 100644 --- a/docs/headers-and-docs.md +++ b/docs/headers-and-docs.md @@ -318,6 +318,10 @@ and `listings`. On Debian and Ubuntu, the packages `texlive-latex-base`, `pdflatex` writes `.pdf` to `doc/`, together with its `.aux` and `.log` files. +This is the PDF of the prototype example. Open it on its own if your browser does not show it here. + + + When `pdflatex` is not on your `PATH`, bust writes the `.tex` and `.html` files, prints `pdflatex is not on PATH, so bust skipped the PDF.` followed by the path of the HTML page, and exits with status 0. bust runs `pdflatex` in batch mode and does not show its output. When diff --git a/scripts/make-example-pdf.sh b/scripts/make-example-pdf.sh new file mode 100755 index 00000000..4a3a1695 --- /dev/null +++ b/scripts/make-example-pdf.sh @@ -0,0 +1,21 @@ +#!/usr/bin/env bash +# Build docs/examples/prototype.pdf, the example PDF the documentation shows, +# from the committed prototype.tex. Read the Docs has no pdflatex, so the PDF is +# committed. Run this after the LaTeX golden changes. +# Usage: scripts/make-example-pdf.sh +set -euo pipefail + +repo="$(cd "$(dirname "$0")/.." && pwd)" +build_dir="$(mktemp -d)" +trap 'rm -rf "$build_dir"' EXIT + +cp "$repo/example/example_prototype/doc/prototype.tex" "$build_dir/" +cd "$build_dir" +# Pin \today and the PDF dates to the time the HTML golden shows. +export SOURCE_DATE_EPOCH=0 FORCE_SOURCE_DATE=1 +# The second run resolves the references the first one writes to the .aux file. +for _ in 1 2; do + pdflatex --interaction=batchmode prototype.tex > /dev/null +done +mkdir -p "$repo/docs/examples" +cp prototype.pdf "$repo/docs/examples/prototype.pdf" From 4b5cda85d8734b1c626822f249a0719e78f0b915 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ola=20Gr=C3=B8ttvik?= Date: Tue, 27 Oct 2026 16:26:11 +0000 Subject: [PATCH 4/8] Share code span conversion and mark unused bit segments explicitly --- bust/editor/diagram.py | 5 +++-- bust/generators/documentation_generator.py | 7 +++---- bust/jinja_utils/filters.py | 17 ++++++++--------- 3 files changed, 14 insertions(+), 15 deletions(-) diff --git a/bust/editor/diagram.py b/bust/editor/diagram.py index d3ab8468..41b6dabf 100644 --- a/bust/editor/diagram.py +++ b/bust/editor/diagram.py @@ -21,6 +21,7 @@ class _Segment: high: int low: int reset: str + is_unused: bool = False @property def width(self) -> int: @@ -47,11 +48,11 @@ def bit_segments(register: Register, data_width: int) -> List[_Segment]: next_high = data_width - 1 for segment in sorted(used, key=lambda s: s.high, reverse=True): if segment.high < next_high: - segments.append(_Segment("unused", next_high, segment.high + 1, "-")) + segments.append(_Segment("unused", next_high, segment.high + 1, "-", True)) segments.append(segment) next_high = segment.low - 1 if next_high >= 0: - segments.append(_Segment("unused", next_high, 0, "-")) + segments.append(_Segment("unused", next_high, 0, "-", True)) return segments diff --git a/bust/generators/documentation_generator.py b/bust/generators/documentation_generator.py index 590c9dae..024b3229 100644 --- a/bust/generators/documentation_generator.py +++ b/bust/generators/documentation_generator.py @@ -17,9 +17,8 @@ ) from bust.jinja_utils.environment import render_template -_FONT = 11 -# An estimate of a character's width at _FONT, enough to tell whether a name -# fits across its box or must be turned on its side. +# An estimate of a character's width at the 11px font of the names, enough to +# tell whether a name fits across its box or must be turned on its side. _CHAR_WIDTH = 7 _NUMBERS_HEIGHT = 16 _RESET_HEIGHT = 18 @@ -63,7 +62,7 @@ def bit_diagram_svg(register, data_width): else: parts.append(_text(x + 3, box_top - 4, segment.high, "start", "num")) parts.append(_text(x + w - 3, box_top - 4, segment.low, "end", "num")) - css_class = "unused" if segment.name == "unused" else "field" + css_class = "unused" if segment.is_unused else "field" parts.append( f'' diff --git a/bust/jinja_utils/filters.py b/bust/jinja_utils/filters.py index 0d904142..d35a9166 100644 --- a/bust/jinja_utils/filters.py +++ b/bust/jinja_utils/filters.py @@ -138,22 +138,21 @@ def utf8tolatex(text): unknown_char_policy="ignore", unknown_char_warning=False, ) - parts = re.split(r"`([^`]*)`", str(text)) - return "".join( - ( - encoder.unicode_to_latex(part) - if i % 2 == 0 - else "\\texttt{" + encoder.unicode_to_latex(part) + "}" - ) - for i, part in enumerate(parts) + return _convert_code_spans( + text, encoder.unicode_to_latex, lambda code: "\\texttt{" + code + "}" ) def utf8tohtml(text): """Escape text for HTML, with a `code` span as , as utf8tolatex sets it in typewriter type.""" + return _convert_code_spans(text, html.escape, lambda code: f"{code}") + + +def _convert_code_spans(text, convert, mark_code): + """Convert all of `text`, and mark each `code` span in it after converting.""" parts = re.split(r"`([^`]*)`", str(text)) return "".join( - html.escape(part) if i % 2 == 0 else "" + html.escape(part) + "" + convert(part) if i % 2 == 0 else mark_code(convert(part)) for i, part in enumerate(parts) ) From 87328ef53856da92cdeb41c9083492995a6be61a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ola=20Gr=C3=B8ttvik?= Date: Tue, 27 Oct 2026 16:29:45 +0000 Subject: [PATCH 5/8] Add test that the example PDF matches the committed prototype.tex --- docs/development.md | 2 +- docs/examples/prototype.tex.sha256 | 1 + scripts/make-example-pdf.sh | 5 ++++- tests/test_example_pdf.py | 20 ++++++++++++++++++++ 4 files changed, 26 insertions(+), 2 deletions(-) create mode 100644 docs/examples/prototype.tex.sha256 create mode 100644 tests/test_example_pdf.py diff --git a/docs/development.md b/docs/development.md index 29c93efd..5cd08bea 100644 --- a/docs/development.md +++ b/docs/development.md @@ -45,7 +45,7 @@ git diff example/ Review the diff before you commit it. It is the clearest record of what your change does to the generated code. -The documentation shows the PDF of the prototype example, which is committed as `docs/examples/prototype.pdf` because Read the Docs has no `pdflatex`. When `example/example_prototype/doc/prototype.tex` changes, rebuild the PDF with `scripts/make-example-pdf.sh`, which needs `pdflatex`. +The documentation shows the PDF of the prototype example, which is committed as `docs/examples/prototype.pdf` because Read the Docs has no `pdflatex`. When `example/example_prototype/doc/prototype.tex` changes, rebuild the PDF with `scripts/make-example-pdf.sh`, which needs `pdflatex`. `tests/test_example_pdf.py` fails until you do: the script records the SHA-256 of the `.tex` it built from in `docs/examples/prototype.tex.sha256`, and the test compares it with the committed `.tex`. ## Simulation diff --git a/docs/examples/prototype.tex.sha256 b/docs/examples/prototype.tex.sha256 new file mode 100644 index 00000000..c6fc85bc --- /dev/null +++ b/docs/examples/prototype.tex.sha256 @@ -0,0 +1 @@ +55bb1fdcd4fa527560302b35775e2958439de26055e7a693f31f8b90949bf07f diff --git a/scripts/make-example-pdf.sh b/scripts/make-example-pdf.sh index 4a3a1695..4486691d 100755 --- a/scripts/make-example-pdf.sh +++ b/scripts/make-example-pdf.sh @@ -1,7 +1,9 @@ #!/usr/bin/env bash # Build docs/examples/prototype.pdf, the example PDF the documentation shows, # from the committed prototype.tex. Read the Docs has no pdflatex, so the PDF is -# committed. Run this after the LaTeX golden changes. +# committed. Run this after the LaTeX golden changes: tests/test_example_pdf.py +# fails until you do, by comparing prototype.tex with the SHA-256 recorded in +# docs/examples/prototype.tex.sha256. # Usage: scripts/make-example-pdf.sh set -euo pipefail @@ -19,3 +21,4 @@ for _ in 1 2; do done mkdir -p "$repo/docs/examples" cp prototype.pdf "$repo/docs/examples/prototype.pdf" +sha256sum prototype.tex | cut -d " " -f 1 > "$repo/docs/examples/prototype.tex.sha256" diff --git a/tests/test_example_pdf.py b/tests/test_example_pdf.py new file mode 100644 index 00000000..fd31aff1 --- /dev/null +++ b/tests/test_example_pdf.py @@ -0,0 +1,20 @@ +"""The example PDF in the documentation is built from the current prototype.tex.""" + +import hashlib +import os + +_REPO_ROOT = os.path.dirname(os.path.dirname(__file__)) +_TEX = os.path.join(_REPO_ROOT, "example", "example_prototype", "doc", "prototype.tex") +_RECORDED_SHA256 = os.path.join(_REPO_ROOT, "docs", "examples", "prototype.tex.sha256") + + +def test_example_pdf_is_built_from_the_current_tex(): + with open(_TEX, "rb") as fp: + tex_sha256 = hashlib.sha256(fp.read()).hexdigest() + with open(_RECORDED_SHA256) as fp: + recorded_sha256 = fp.read().strip() + + assert tex_sha256 == recorded_sha256, ( + "prototype.tex changed since docs/examples/prototype.pdf was built. " + "Run scripts/make-example-pdf.sh and commit the PDF." + ) From 73e0077b61f41222d58876721316309ee5c8f8cd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ola=20Gr=C3=B8ttvik?= Date: Tue, 27 Oct 2026 16:33:16 +0000 Subject: [PATCH 6/8] Check commit dates instead of a hash for the example PDF --- .github/workflows/python_tests.yml | 3 +++ docs/development.md | 2 +- docs/examples/prototype.tex.sha256 | 1 - scripts/make-example-pdf.sh | 4 +-- tests/test_example_pdf.py | 40 ++++++++++++++++++++++-------- 5 files changed, 34 insertions(+), 16 deletions(-) delete mode 100644 docs/examples/prototype.tex.sha256 diff --git a/.github/workflows/python_tests.yml b/.github/workflows/python_tests.yml index beb8d40f..54fe9691 100644 --- a/.github/workflows/python_tests.yml +++ b/.github/workflows/python_tests.yml @@ -37,6 +37,9 @@ jobs: steps: - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + # tests/test_example_pdf.py compares the commit dates of two files. + fetch-depth: 0 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0 with: diff --git a/docs/development.md b/docs/development.md index 5cd08bea..d4fc4e66 100644 --- a/docs/development.md +++ b/docs/development.md @@ -45,7 +45,7 @@ git diff example/ Review the diff before you commit it. It is the clearest record of what your change does to the generated code. -The documentation shows the PDF of the prototype example, which is committed as `docs/examples/prototype.pdf` because Read the Docs has no `pdflatex`. When `example/example_prototype/doc/prototype.tex` changes, rebuild the PDF with `scripts/make-example-pdf.sh`, which needs `pdflatex`. `tests/test_example_pdf.py` fails until you do: the script records the SHA-256 of the `.tex` it built from in `docs/examples/prototype.tex.sha256`, and the test compares it with the committed `.tex`. +The documentation shows the PDF of the prototype example, which is committed as `docs/examples/prototype.pdf` because Read the Docs has no `pdflatex`. When `example/example_prototype/doc/prototype.tex` changes, rebuild the PDF with `scripts/make-example-pdf.sh`, which needs `pdflatex`. `tests/test_example_pdf.py` fails until you do: it checks in the git history that the last commit that changed the PDF is no older than the last commit that changed the `.tex`. ## Simulation diff --git a/docs/examples/prototype.tex.sha256 b/docs/examples/prototype.tex.sha256 deleted file mode 100644 index c6fc85bc..00000000 --- a/docs/examples/prototype.tex.sha256 +++ /dev/null @@ -1 +0,0 @@ -55bb1fdcd4fa527560302b35775e2958439de26055e7a693f31f8b90949bf07f diff --git a/scripts/make-example-pdf.sh b/scripts/make-example-pdf.sh index 4486691d..d8a7fd7b 100755 --- a/scripts/make-example-pdf.sh +++ b/scripts/make-example-pdf.sh @@ -2,8 +2,7 @@ # Build docs/examples/prototype.pdf, the example PDF the documentation shows, # from the committed prototype.tex. Read the Docs has no pdflatex, so the PDF is # committed. Run this after the LaTeX golden changes: tests/test_example_pdf.py -# fails until you do, by comparing prototype.tex with the SHA-256 recorded in -# docs/examples/prototype.tex.sha256. +# fails until the PDF is committed with or after prototype.tex. # Usage: scripts/make-example-pdf.sh set -euo pipefail @@ -21,4 +20,3 @@ for _ in 1 2; do done mkdir -p "$repo/docs/examples" cp prototype.pdf "$repo/docs/examples/prototype.pdf" -sha256sum prototype.tex | cut -d " " -f 1 > "$repo/docs/examples/prototype.tex.sha256" diff --git a/tests/test_example_pdf.py b/tests/test_example_pdf.py index fd31aff1..1ed8e8b6 100644 --- a/tests/test_example_pdf.py +++ b/tests/test_example_pdf.py @@ -1,20 +1,38 @@ -"""The example PDF in the documentation is built from the current prototype.tex.""" +"""The example PDF in the documentation is rebuilt whenever prototype.tex +changes: the last commit that changed the PDF is no older than the last commit +that changed the .tex.""" -import hashlib import os +import shutil +import subprocess + +import pytest _REPO_ROOT = os.path.dirname(os.path.dirname(__file__)) -_TEX = os.path.join(_REPO_ROOT, "example", "example_prototype", "doc", "prototype.tex") -_RECORDED_SHA256 = os.path.join(_REPO_ROOT, "docs", "examples", "prototype.tex.sha256") +_TEX = os.path.join("example", "example_prototype", "doc", "prototype.tex") +_PDF = os.path.join("docs", "examples", "prototype.pdf") + + +def _last_commit_time(path): + """The committer time, in seconds since the epoch, of the last commit that + changed `path`.""" + output = subprocess.run( + ["git", "log", "-1", "--format=%ct", "--", path], + cwd=_REPO_ROOT, + capture_output=True, + text=True, + check=True, + ).stdout + return int(output) -def test_example_pdf_is_built_from_the_current_tex(): - with open(_TEX, "rb") as fp: - tex_sha256 = hashlib.sha256(fp.read()).hexdigest() - with open(_RECORDED_SHA256) as fp: - recorded_sha256 = fp.read().strip() +def test_example_pdf_is_committed_with_or_after_the_tex(): + if shutil.which("git") is None or not os.path.exists( + os.path.join(_REPO_ROOT, ".git") + ): + pytest.skip("needs the git history of the repository") - assert tex_sha256 == recorded_sha256, ( - "prototype.tex changed since docs/examples/prototype.pdf was built. " + assert _last_commit_time(_PDF) >= _last_commit_time(_TEX), ( + f"{_TEX} changed after {_PDF} was last committed. " "Run scripts/make-example-pdf.sh and commit the PDF." ) From ae9b1244fd0c2b92297be742c8ceac5ec125814a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ola=20Gr=C3=B8ttvik?= Date: Tue, 27 Oct 2026 19:26:01 +0000 Subject: [PATCH 7/8] Rebuild the example PDF in CI instead of checking commit dates --- .github/workflows/example_pdf.yml | 48 ++++++++++++++++++++++++++++++ .github/workflows/python_tests.yml | 3 -- docs/development.md | 2 +- scripts/make-example-pdf.sh | 4 +-- tests/test_example_pdf.py | 38 ----------------------- 5 files changed, 51 insertions(+), 44 deletions(-) create mode 100644 .github/workflows/example_pdf.yml delete mode 100644 tests/test_example_pdf.py diff --git a/.github/workflows/example_pdf.yml b/.github/workflows/example_pdf.yml new file mode 100644 index 00000000..28600fdf --- /dev/null +++ b/.github/workflows/example_pdf.yml @@ -0,0 +1,48 @@ +name: Example PDF + +# docs/examples/prototype.pdf is committed because Read the Docs has no +# pdflatex. Rebuild it from the committed prototype.tex and fail if it differs, +# so the PDF in the documentation cannot fall behind the LaTeX golden. +on: + push: + branches: ["master"] + paths: + - "example/example_prototype/doc/prototype.tex" + - "docs/examples/prototype.pdf" + - "scripts/make-example-pdf.sh" + - ".github/workflows/example_pdf.yml" + pull_request: + branches: ["**"] + paths: + - "example/example_prototype/doc/prototype.tex" + - "docs/examples/prototype.pdf" + - "scripts/make-example-pdf.sh" + - ".github/workflows/example_pdf.yml" + workflow_dispatch: + +permissions: + contents: read + +concurrency: + group: example-pdf-${{ github.ref }} + cancel-in-progress: true + +jobs: + rebuild: + # Pinned: the PDF is byte-for-byte reproducible only with the same TeX Live, + # and the committed file was built with TeX Live 2023 from Ubuntu 24.04. + runs-on: ubuntu-24.04 + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + - name: Install pdflatex + run: | + sudo apt-get update + sudo apt-get install -y texlive-latex-base texlive-latex-recommended texlive-latex-extra + - name: Rebuild the example PDF + run: scripts/make-example-pdf.sh + - name: Compare with the committed PDF + run: | + if ! git diff --quiet -- docs/examples/prototype.pdf; then + echo "::error file=docs/examples/prototype.pdf::The committed PDF does not match prototype.tex. Run scripts/make-example-pdf.sh on Ubuntu 24.04 and commit the PDF." + exit 1 + fi diff --git a/.github/workflows/python_tests.yml b/.github/workflows/python_tests.yml index 54fe9691..beb8d40f 100644 --- a/.github/workflows/python_tests.yml +++ b/.github/workflows/python_tests.yml @@ -37,9 +37,6 @@ jobs: steps: - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 - with: - # tests/test_example_pdf.py compares the commit dates of two files. - fetch-depth: 0 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0 with: diff --git a/docs/development.md b/docs/development.md index d4fc4e66..46dfbfb8 100644 --- a/docs/development.md +++ b/docs/development.md @@ -45,7 +45,7 @@ git diff example/ Review the diff before you commit it. It is the clearest record of what your change does to the generated code. -The documentation shows the PDF of the prototype example, which is committed as `docs/examples/prototype.pdf` because Read the Docs has no `pdflatex`. When `example/example_prototype/doc/prototype.tex` changes, rebuild the PDF with `scripts/make-example-pdf.sh`, which needs `pdflatex`. `tests/test_example_pdf.py` fails until you do: it checks in the git history that the last commit that changed the PDF is no older than the last commit that changed the `.tex`. +The documentation shows the PDF of the prototype example, which is committed as `docs/examples/prototype.pdf` because Read the Docs has no `pdflatex`. When `example/example_prototype/doc/prototype.tex` changes, rebuild the PDF with `scripts/make-example-pdf.sh`, which needs `pdflatex`. The `Example PDF` workflow rebuilds the PDF on Ubuntu 24.04 whenever the `.tex`, the PDF or the script changes, and fails if the result differs from the committed file. The build is byte-for-byte reproducible with the same TeX Live, so build it on Ubuntu 24.04 (TeX Live 2023) too. ## Simulation diff --git a/scripts/make-example-pdf.sh b/scripts/make-example-pdf.sh index d8a7fd7b..76591055 100755 --- a/scripts/make-example-pdf.sh +++ b/scripts/make-example-pdf.sh @@ -1,8 +1,8 @@ #!/usr/bin/env bash # Build docs/examples/prototype.pdf, the example PDF the documentation shows, # from the committed prototype.tex. Read the Docs has no pdflatex, so the PDF is -# committed. Run this after the LaTeX golden changes: tests/test_example_pdf.py -# fails until the PDF is committed with or after prototype.tex. +# committed. Run this after the LaTeX golden changes: the example_pdf workflow +# rebuilds the PDF and fails if it differs from the committed one. # Usage: scripts/make-example-pdf.sh set -euo pipefail diff --git a/tests/test_example_pdf.py b/tests/test_example_pdf.py deleted file mode 100644 index 1ed8e8b6..00000000 --- a/tests/test_example_pdf.py +++ /dev/null @@ -1,38 +0,0 @@ -"""The example PDF in the documentation is rebuilt whenever prototype.tex -changes: the last commit that changed the PDF is no older than the last commit -that changed the .tex.""" - -import os -import shutil -import subprocess - -import pytest - -_REPO_ROOT = os.path.dirname(os.path.dirname(__file__)) -_TEX = os.path.join("example", "example_prototype", "doc", "prototype.tex") -_PDF = os.path.join("docs", "examples", "prototype.pdf") - - -def _last_commit_time(path): - """The committer time, in seconds since the epoch, of the last commit that - changed `path`.""" - output = subprocess.run( - ["git", "log", "-1", "--format=%ct", "--", path], - cwd=_REPO_ROOT, - capture_output=True, - text=True, - check=True, - ).stdout - return int(output) - - -def test_example_pdf_is_committed_with_or_after_the_tex(): - if shutil.which("git") is None or not os.path.exists( - os.path.join(_REPO_ROOT, ".git") - ): - pytest.skip("needs the git history of the repository") - - assert _last_commit_time(_PDF) >= _last_commit_time(_TEX), ( - f"{_TEX} changed after {_PDF} was last committed. " - "Run scripts/make-example-pdf.sh and commit the PDF." - ) From 79ff1001ad001cdf06cf36fdecdece2da1cce6c5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ola=20Gr=C3=B8ttvik?= Date: Tue, 27 Oct 2026 19:29:15 +0000 Subject: [PATCH 8/8] Build the example PDF during the docs build instead of committing it --- .github/workflows/example_pdf.yml | 48 -------------------------- .readthedocs.yaml | 6 ++++ docs/conf.py | 55 +++++++++++++++++++++++------- docs/development.md | 2 -- docs/examples/prototype.pdf | Bin 132569 -> 0 bytes scripts/make-example-pdf.sh | 22 ------------ 6 files changed, 48 insertions(+), 85 deletions(-) delete mode 100644 .github/workflows/example_pdf.yml delete mode 100644 docs/examples/prototype.pdf delete mode 100755 scripts/make-example-pdf.sh diff --git a/.github/workflows/example_pdf.yml b/.github/workflows/example_pdf.yml deleted file mode 100644 index 28600fdf..00000000 --- a/.github/workflows/example_pdf.yml +++ /dev/null @@ -1,48 +0,0 @@ -name: Example PDF - -# docs/examples/prototype.pdf is committed because Read the Docs has no -# pdflatex. Rebuild it from the committed prototype.tex and fail if it differs, -# so the PDF in the documentation cannot fall behind the LaTeX golden. -on: - push: - branches: ["master"] - paths: - - "example/example_prototype/doc/prototype.tex" - - "docs/examples/prototype.pdf" - - "scripts/make-example-pdf.sh" - - ".github/workflows/example_pdf.yml" - pull_request: - branches: ["**"] - paths: - - "example/example_prototype/doc/prototype.tex" - - "docs/examples/prototype.pdf" - - "scripts/make-example-pdf.sh" - - ".github/workflows/example_pdf.yml" - workflow_dispatch: - -permissions: - contents: read - -concurrency: - group: example-pdf-${{ github.ref }} - cancel-in-progress: true - -jobs: - rebuild: - # Pinned: the PDF is byte-for-byte reproducible only with the same TeX Live, - # and the committed file was built with TeX Live 2023 from Ubuntu 24.04. - runs-on: ubuntu-24.04 - steps: - - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 - - name: Install pdflatex - run: | - sudo apt-get update - sudo apt-get install -y texlive-latex-base texlive-latex-recommended texlive-latex-extra - - name: Rebuild the example PDF - run: scripts/make-example-pdf.sh - - name: Compare with the committed PDF - run: | - if ! git diff --quiet -- docs/examples/prototype.pdf; then - echo "::error file=docs/examples/prototype.pdf::The committed PDF does not match prototype.tex. Run scripts/make-example-pdf.sh on Ubuntu 24.04 and commit the PDF." - exit 1 - fi diff --git a/.readthedocs.yaml b/.readthedocs.yaml index fd497d03..ad45a5b1 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -4,6 +4,12 @@ build: os: ubuntu-24.04 tools: python: "3.13" + # pdflatex and the LaTeX packages of the documentation, for the example PDF + # that docs/conf.py builds. + apt_packages: + - texlive-latex-base + - texlive-latex-recommended + - texlive-latex-extra sphinx: configuration: docs/conf.py diff --git a/docs/conf.py b/docs/conf.py index e2a15140..2c740c51 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -1,6 +1,8 @@ # SPDX-License-Identifier: Apache-2.0 import os import shutil +import subprocess +import tempfile from bust._version import __VERSION__ @@ -12,7 +14,7 @@ extensions = ["myst_parser"] myst_heading_anchors = 3 -exclude_patterns = ["_build", "examples"] +exclude_patterns = ["_build"] html_theme = "furo" html_title = "bust" @@ -60,24 +62,51 @@ } -# The documentation bust generated for the prototype example, copied into the -# built site so the docs can show it. The HTML is the committed golden, which -# the tests keep in step with the generator. Read the Docs has no pdflatex, so -# the PDF is committed too: scripts/make-example-pdf.sh rebuilds it. -_EXAMPLE_DOCS = [ - os.path.join("..", "example", "example_prototype", "doc", "prototype.html"), - os.path.join("examples", "prototype.pdf"), -] +# The documentation bust generated for the prototype example, put into the +# built site so the docs can show it. Both come from the committed goldens, +# which the tests keep in step with the generator: the HTML is copied, and the +# PDF is built from the .tex. Read the Docs installs pdflatex for that (see +# .readthedocs.yaml). Elsewhere the PDF is left out when pdflatex is missing. +_EXAMPLE_DOC = os.path.join("..", "example", "example_prototype", "doc", "prototype") -def _copy_example_docs(app, exception): +def _add_example_docs(app, exception): if exception is not None or app.builder.format != "html": return examples_dir = os.path.join(app.outdir, "examples") os.makedirs(examples_dir, exist_ok=True) - for path in _EXAMPLE_DOCS: - shutil.copy(os.path.join(app.confdir, path), examples_dir) + example = os.path.join(app.confdir, _EXAMPLE_DOC) + shutil.copy(example + ".html", examples_dir) + _build_example_pdf(example + ".tex", examples_dir) + + +def _build_example_pdf(tex, out_dir): + pdflatex = shutil.which("pdflatex") + if pdflatex is None: + if os.environ.get("READTHEDOCS") == "True": + raise RuntimeError( + "pdflatex is missing, so the example PDF cannot be built" + ) + return + with tempfile.TemporaryDirectory() as build_dir: + # The second run resolves the references the first one writes to the + # .aux file. + for _ in range(2): + subprocess.run( + [ + pdflatex, + "--interaction=batchmode", + f"--output-directory={build_dir}", + tex, + ], + stdout=subprocess.DEVNULL, + check=True, + # The same date as the HTML example, which pins it for the goldens. + env=dict(os.environ, SOURCE_DATE_EPOCH="0", FORCE_SOURCE_DATE="1"), + ) + name = os.path.splitext(os.path.basename(tex))[0] + ".pdf" + shutil.copy(os.path.join(build_dir, name), out_dir) def setup(app): - app.connect("build-finished", _copy_example_docs) + app.connect("build-finished", _add_example_docs) diff --git a/docs/development.md b/docs/development.md index 46dfbfb8..21369605 100644 --- a/docs/development.md +++ b/docs/development.md @@ -45,8 +45,6 @@ git diff example/ Review the diff before you commit it. It is the clearest record of what your change does to the generated code. -The documentation shows the PDF of the prototype example, which is committed as `docs/examples/prototype.pdf` because Read the Docs has no `pdflatex`. When `example/example_prototype/doc/prototype.tex` changes, rebuild the PDF with `scripts/make-example-pdf.sh`, which needs `pdflatex`. The `Example PDF` workflow rebuilds the PDF on Ubuntu 24.04 whenever the `.tex`, the PDF or the script changes, and fails if the result differs from the committed file. The build is byte-for-byte reproducible with the same TeX Live, so build it on Ubuntu 24.04 (TeX Live 2023) too. - ## Simulation `sim/` simulates the generated example testbenches, and the hand-written diff --git a/docs/examples/prototype.pdf b/docs/examples/prototype.pdf deleted file mode 100644 index aa3cc15990a69cd82d97d9c579d022cf9fed78a6..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 132569 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�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

9Nhtn@g(YM$6?nxS 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 YwRg4!-#2Df7A7thL<$N~Suw=_2UK781poj5 diff --git a/scripts/make-example-pdf.sh b/scripts/make-example-pdf.sh deleted file mode 100755 index 76591055..00000000 --- a/scripts/make-example-pdf.sh +++ /dev/null @@ -1,22 +0,0 @@ -#!/usr/bin/env bash -# Build docs/examples/prototype.pdf, the example PDF the documentation shows, -# from the committed prototype.tex. Read the Docs has no pdflatex, so the PDF is -# committed. Run this after the LaTeX golden changes: the example_pdf workflow -# rebuilds the PDF and fails if it differs from the committed one. -# Usage: scripts/make-example-pdf.sh -set -euo pipefail - -repo="$(cd "$(dirname "$0")/.." && pwd)" -build_dir="$(mktemp -d)" -trap 'rm -rf "$build_dir"' EXIT - -cp "$repo/example/example_prototype/doc/prototype.tex" "$build_dir/" -cd "$build_dir" -# Pin \today and the PDF dates to the time the HTML golden shows. -export SOURCE_DATE_EPOCH=0 FORCE_SOURCE_DATE=1 -# The second run resolves the references the first one writes to the .aux file. -for _ in 1 2; do - pdflatex --interaction=batchmode prototype.tex > /dev/null -done -mkdir -p "$repo/docs/examples" -cp prototype.pdf "$repo/docs/examples/prototype.pdf"