DVLib

Documentation
Source

The project-local package tree and deterministic simulator handoff.

Installed layout and dvlib.f

Install layout

my_testbench/
├── dvlib.toml
├── dvlib.lock
├── dvlib.f
└── dvlib_packages/
    ├── common_utils/
    │   └── common_utils.f
    └── axi_agent/
        └── axi_agent.f

Only one directory exists per package name. Per-package fragments and the root filelist use paths relative to the consuming project.

Dependency-first ordering

The filelist topologically orders packages so dependencies appear before dependents. Alphabetical order breaks ties for deterministic output. Inside each package, include directories, defines, and sources follow the manifest.

dvlib.f text
// Generated by dvlib. Do not edit by hand.
// --- common_utils ---
+incdir+dvlib_packages/common_utils/src
dvlib_packages/common_utils/src/common_pkg.sv
// --- axi_agent ---
+define+AXI_DATA_WIDTH=64
dvlib_packages/axi_agent/src/axi_pkg.sv

Cleaning generated state

dvlib clean removes dvlib_packages/ and dvlib.f but deliberately keeps dvlib.lock. The next install can reconstruct the local tree from the pinned graph.