class MyModule(Elaboratable):
    def __init__(self, param: int):
        self.param = param
        self.out = Signal()
    ...

# the largest issue is the lack of a consistent cli interface to expect from a given file
if __name__ == "__main__":
    top = MyModule(param=4) # warning: MustUse

    if sys.argv[1] = "build":
        if sys.argv[2] = "icebreaker":
            plat = ICEBreakerPlatform()
            plat.add_resources(...)

        elif sys.argv[2] = "fomu"
            plat = FomuHackerPlatform()
            plat.add_resources(...)

        # `do_program` is usually hard-coded.
        # The folder "build" should also be configurable
        plat.build(top, do_program=True)

    elif sys.argv[1] == "test": # "simulate" already taken in main
        # logic for multiple simulations to select from is manually made
        sim = Simulator(top)

        def my_proc():
            yield ...
        sim.add_sync_process(my_proc)

        with sim.write_vcd("uart.vcd", "uart.gtkw"): # hardcoded filenames, never printed to user
            sim.run()

    else:
        main(top, ports=[ top.out ]) # '-h' doesn't mention the two modes defined above




# === can become: ===




class MyModule(Elaboratable):
    def __init__(self, param):
        self.param = param
        self.out = Signal()
    ...

if __name__ == "__main__":
    platforms, simulations = [], []

    # supporting multiple platforms encourages designing the
    # top-level module in a platform agnostic way

    @platforms.append
    def icebreaker(): # function.__name__ is used by the cli interface in nMain
        plat = ICEBreakerPlatform()
        plat.add_resources(...)
        return plat

    @platforms.append
    def fomu():
        plat = FomuHackerPlatform()
        plat.add_resources(...)
        return plat

    @simulations.append
    def sim_the_foo(sim): # sim = Simulator(design)
        sim.add_clock(1e-6)

        @sim.add_sync_process
        def my_proc():
            yield ...
        # sim could then be automatically run, with configurable filenames

    nMain(
        name = "blinker", # current default is "top", perhaps use design().__class__.__name__ ?
        design = lambda: MyModule(param=4), # avoid MustUse warnings
        ports = lambda x: [ x.out ], # optional, platform.request is a thing
        platforms = platforms, # optional
        simulations = simulations, # optional
    )