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/vhdl/tb_vunit_pkg.vhd

@@ -0,0 +1,26 @@
+-- This Source Code Form is subject to the terms of the Mozilla Public
+-- License, v. 2.0. If a copy of the MPL was not distributed with this file,
+-- You can obtain one at http://mozilla.org/MPL/2.0/.
+--
+-- Copyright (c) 2014-2026, Lars Asplund lars.anders.asplund@gmail.com
+
+library vunit_lib;
+context vunit_lib.vunit_context;
+
+library foo_lib;
+use foo_lib.foo_pkg.all;
+
+entity tb_vunit_pkg is
+  generic (runner_cfg : string);
+end entity;
+
+architecture vunit_test_bench of tb_vunit_pkg is
+begin
+  test_runner : process
+  begin
+    test_runner_setup(runner, runner_cfg);
+    check(foo_pkg_is_present);
+    test_runner_cleanup(runner);
+    wait;
+  end process;
+end architecture;

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

@@ -0,0 +1,7 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this file,
+# You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# Copyright (c) 2014-2026, Lars Asplund lars.anders.asplund@gmail.com
+
+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,9 @@
+-- This Source Code Form is subject to the terms of the Mozilla Public
+-- License, v. 2.0. If a copy of the MPL was not distributed with this file,
+-- You can obtain one at http://mozilla.org/MPL/2.0/.
+--
+-- Copyright (c) 2014-2026, Lars Asplund lars.anders.asplund@gmail.com
+
+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,10 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this file,
+# You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+# Copyright (c) 2014-2026, Lars Asplund lars.anders.asplund@gmail.com
+
+[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"),
 )