Integrations¶
A .src list is a text file with one absolute path per line, so most tools can
read it directly or through a short loop. For a tool that resolves the entries
against a directory of its own, --relative-to DIR writes them relative to
DIR instead. --format hog writes the list files of a
hog
project directly, with the top module marked. Runnable, self-checking examples live
in examples/. Each
tool has a simple example (one library) and an advanced one (three libraries
compiled in the order of libraries.src). The examples marked “CI” run in CI.
The vendor-tool examples are marked “docs only”: they are checked against the
vendor’s documentation but can’t run on a public CI runner.
Tool |
Simple |
Advanced |
Verified |
|---|---|---|---|
CI |
|||
CI |
|||
CI |
|||
CI |
|||
CI |
|||
CI |
|||
CI (list files) |
|||
docs only |
|||
docs only |
|||
docs only |
For example, feeding ohsh output to GHDL:
ohsh -t my_project -o build top
while IFS= read -r lib; do
[ -f "build/${lib}_vhdl.src" ] || continue
while IFS= read -r f; do ghdl -a --work="$lib" --std=08 "$f"; done < "build/${lib}_vhdl.src"
done < build/libraries.src
ghdl -e --std=08 top && ghdl -r --std=08 top