add cocotb.parameterize() similar to nox.parameterize()

[AndrewNolte]

• cocotb.parameterize() allows for more idiomatic generation of parameterized tests
• factory.generate_tests() now takes test_dec as an arg, meaning normal test() kwargs are now possible to specify on factory tests

[codecov]

Codecov Report

Attention: 2 lines in your changes are missing coverage. Please review.

Comparison is base (b26f135) 52.15% compared to head (808890f) 66.54%.

Files	Patch %	Lines
src/cocotb/regression.py	95.55%	2 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           master    #3513       +/-   ##
===========================================
+ Coverage   52.15%   66.54%   +14.39%     
===========================================
  Files          49       49               
  Lines        8433     8453       +20     
  Branches     2386     2388        +2     
===========================================
+ Hits         4398     5625     +1227     
+ Misses       3334     1708     -1626     
- Partials      701     1120      +419     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[ktbarrett]

We haven't discussed raising the required Python version, so it's still 3.6+. I do like this change, I'll try to find some time to review tomorrow. I've been kinda busy recently.

[ktbarrett]

There is no need to move _create_test and TestFactory to decorators.py

[AndrewNolte]

There is no need to move _create_test and TestFactory to decorators.py

If it was left there would be a circular import, regression.py has from cocotb.decorators import Test, and so this change would then have decorators importing from regression.

[ktbarrett]

Ah yes. That crap again. There's probably a better way to go about it. If moving Test to regression.py works, I'd prefer that, as it's a better model of whose responsible for what.

[AndrewNolte]

Ah yes. That crap again. There's probably a better way to go about it. If moving Test to regression.py works, I'd prefer that, as it's a better model of whose responsible for what.

I don't think this'll work either, because the test() decorator has to check if it's being passed a TestFactory. I think it makes sense to put the Test class and TestFactory class in a separate file, maybe test_types.py? Then decorators.py and regression.py can import from that

[ktbarrett]

It should be possible now that Test doesn't inherit from coroutine.

[ktbarrett]

Nice. It just needs a newsfragment. There's a README in /docs/source/newsfragments/ that details how to do that. Thanks for this!

[cmarqu]

Changing the log level is a bit of an unrelated behavioral change which I don't mind but wanted to point out.

[cmarqu]

I was going to suggest adding a note about this nice functionality to where we describe how to actually use TestFactory, but it turns out we don't have such a section at all.