amaranth/tests
whitequark b65e11f38f sim: split into base, core, and engines.
Before this commit, each simulation engine (which is only pysim at
the moment, but also cxxsim soon) was a subclass of SimulatorCore,
and every simulation engine module would essentially duplicate
the complete structure of a simulator, with code partially shared.

This was a really bad idea: it was inconvenient to use, with
downstream code having to branch between e.g. PySettle and CxxSettle;
it had no well-defined external interface; it had multiple virtually
identical entry points; and it had no separation between simulation
algorithms and glue code.

This commit completely rearranges simulation code.
  1. sim._base defines internal simulation interfaces. The clarity of
     these internal interfaces is important because simulation
     engines mix and match components to provide a consistent API
     regardless of the chosen engine.
  2. sim.core defines the external simulation interface: the commands
     and the simulator facade. The facade provides a single entry
     point and, when possible, validates or lowers user input.
     It also imports built-in simulation engines by their symbolic
     name, avoiding eager imports of pyvcd or ctypes.
  3. sim.xxxsim (currently, only sim.pysim) defines the simulator
     implementation: time and state management, process scheduling,
     and waveform dumping.

The new simulator structure has none of the downsides of the old one.

See #324.
2020-08-27 11:52:31 +00:00
..
compat tests: move out of the main package. 2020-08-27 00:33:31 +00:00
__init__.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_build_dsl.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_build_plat.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_build_res.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_compat.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_examples.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_hdl_ast.py hdl.ast: clarify exception message for out of bounds indexing. 2020-08-27 01:14:05 +00:00
test_hdl_cd.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_hdl_dsl.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_hdl_ir.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_hdl_mem.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_hdl_rec.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_hdl_xfrm.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00
test_lib_cdc.py sim: split into base, core, and engines. 2020-08-27 11:52:31 +00:00
test_lib_coding.py sim: split into base, core, and engines. 2020-08-27 11:52:31 +00:00
test_lib_fifo.py sim: split into base, core, and engines. 2020-08-27 11:52:31 +00:00
test_lib_io.py sim: split into base, core, and engines. 2020-08-27 11:52:31 +00:00
test_lib_scheduler.py sim: split into base, core, and engines. 2020-08-27 11:52:31 +00:00
test_sim.py sim: split into base, core, and engines. 2020-08-27 11:52:31 +00:00
test_toolchain_cxx.py _toolchain.cxx: new toolchain. 2020-08-27 06:39:00 +00:00
utils.py tests: move out of the main package. 2020-08-27 00:33:31 +00:00