Added initial support for external package addition.

Author: LarsAsplund

pyproject.toml

@@ -36,6 +36,7 @@ classifiers = [
 requires-python = ">=3.10"
 dependencies = [
     "colorama",
+    "tomli; python_version < '3.11'",
 ]
 
 [tool.setuptools]

tests/acceptance/artificial/vhdl/run.py

@@ -4,6 +4,7 @@
 #
 # Copyright (c) 2014-2026, Lars Asplund lars.anders.asplund@gmail.com
 
+import sys
 from pathlib import Path
 from glob import glob
 from vunit import VUnit, VUnitCLI
@@ -164,6 +165,7 @@ def pre_config(output_path):
     for idx, (extra_time, fail) in enumerate([(5, False), (2, True)], 1):
         tb.add_config(name=f"test_{idx}", pre_config=make_pre_config(idx, extra_time, fail))
 
+
 def configure_tb_seed(ui):
     tb = ui.library("lib").test_bench("tb_seed")
 
@@ -174,6 +176,12 @@ def configure_tb_seed(ui):
         tb.test("test_1").set_generic("expected_seed", "ffa08cd9489aad14")
         tb.test("test_2").set_generic("expected_seed", "9a292b3679afd081")
 
+
+def configure_tb_vunit_pkg(vu):
+    sys.path.append(str(root.parent / "vunit_pkg"))
+    vu.add_package("foo")
+
+
 configure_tb_with_generic_config()
 configure_tb_same_sim_all_pass(vu)
 configure_tb_set_generic(vu)
@@ -182,6 +190,7 @@ def configure_tb_seed(ui):
 configure_tb_no_fail_on_warning(vu)
 configure_tb_test_prio(vu)
 configure_tb_seed(vu)
+configure_tb_vunit_pkg(vu)
 lib.entity("tb_no_generic_override").set_generic("g_val", False)
 lib.entity("tb_ieee_warning").test("pass").set_sim_option("disable_ieee_warnings", True)
 lib.entity("tb_other_file_tests").scan_tests_from_file(str(root / "other_file_tests.vhd"))

tests/acceptance/artificial/vunit_pkg/foo/__init__.py

@@ -0,0 +1 @@
+raise RuntimeError("This file must not be executed when adding foo as a VUnit package.")

tests/acceptance/artificial/vunit_pkg/foo/foo_pkg.vhd

@@ -0,0 +1,3 @@
+package foo_pkg is
+  constant foo_pkg_is_present : boolean := true;
+end package;

tests/acceptance/artificial/vunit_pkg/foo/vunit_pkg.toml

@@ -0,0 +1,4 @@
+[package]
+library = "foo_lib"
+[[package.sources]]
+include=["foo_pkg.vhd"]

tests/acceptance/test_artificial.py

@@ -107,6 +107,13 @@ def test_repeated_seed(self):
             ],
         )
 
+    def test_not_executing_package_init_on_package_addition(self):
+        self.check(self.artificial_run_vhdl, args=["lib.tb_vunit_pkg.all"])
+        check_report(
+            self.report_file,
+            [("passed", "lib.tb_vunit_pkg.all")],
+        )
+
     def _test_artificial(self, args=None):
         """
         Utility function to run and check the result of all test benches
@@ -311,4 +318,5 @@ def test_exit_0_flag(self):
     ("failed", "lib.tb_test_prio_2.test_2"),
     ("passed", "lib.tb_seed.test_1"),
     ("passed", "lib.tb_seed.test_2"),
+    ("passed", "lib.tb_vunit_pkg.all"),
 )