pytest-fusesoc 0.1.6

Pytest plugin to run FuseSoC simulation targets.

pytest-fusesoc

Why pytest-fusesoc plugin?

The pytest-fusesoc plugin allows you to use pytest to discover and run simulation targets defined in FuseSoC *.core files. Furthermore, testing capabilities can be greatly enhanced with existing pytest plugins, built-in pytest features like fixtures, test parametrization @pytest.mark.parametrize, test reporting, and more.

How the pytest-fusesoc plugin works?

To begin, it recursively collects all FuseSoC *.core files from the directory where pytest was invoked. Then, it collects all simulation targets from each collected FuseSoC core. Each collected simulation target is represented as a standalone pytest test that invokes the fusesoc command with the required arguments during test execution.

Example output from the pytest --collect-only command:

<Dir my-awesome-hdl-project>
  <Dir rtl>
    <Dir adder>
      <File adder.core>
        <Target testbench-1>
        <Target testbench-2>
    <Dir alu>
      <File alu.core>
        <Target testbench-1>
        <Target testbench-2>

Example pytest command to run specific testbench:

pytest -k 'adder.core and testbench-1'

Alternatively when using VLN (<vendor>:<library>:<name>) of FuseSoC core:

pytest -k 'john:mylib:adder and testbench-1'