Skip to content

Document the simulator #1374

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jun 10, 2024
Merged

Conversation

whitequark
Copy link
Member

@whitequark whitequark commented Jun 5, 2024

@whitequark whitequark marked this pull request as draft June 5, 2024 03:07
Copy link

codecov bot commented Jun 5, 2024

Codecov Report

Attention: Patch coverage is 91.66667% with 8 lines in your changes missing coverage. Please review.

Project coverage is 91.09%. Comparing base (496432e) to head (52b12a6).
Report is 20 commits behind head on main.

Current head 52b12a6 differs from pull request most recent head bf905ad

Please upload reports for the commit bf905ad to get more accurate results.

Files Patch % Lines
amaranth/sim/core.py 92.30% 2 Missing and 2 partials ⚠️
amaranth/sim/_async.py 91.66% 2 Missing and 1 partial ⚠️
amaranth/sim/_pycoro.py 0.00% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main    #1374      +/-   ##
==========================================
+ Coverage   90.99%   91.09%   +0.09%     
==========================================
  Files          45       45              
  Lines       11218    11302      +84     
  Branches     2429     2763     +334     
==========================================
+ Hits        10208    10295      +87     
+ Misses        831      830       -1     
+ Partials      179      177       -2     

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

@whitequark whitequark force-pushed the document-simulator branch from 57743d9 to bf905ad Compare June 10, 2024 10:27
This commit includes additional non-documentation changes, related to
issues found while documenting it:
- `Simulator.run_until()` no longer accepts a `run_passive=` argument.
  Passive no longer exist and in any case defaulting to `False` does not
  make a lot of sense from an API perspective.
- `add_clock()`'s `phase=` argument, when specified, no longer has
  `period/2` added to it. This wasn't the documented behavior in first
  place and it makes no sense to do that.
- `add_clock()` raises a `NameError` if a clock domain does not exist,
  instead of `ValueError`.
- `add_clock()` raises a `DriverConflict` if a clock domain is already
  being driven by a clock, instead of `ValueError`.
- GTKWave is no longer a part of the installation instructions, and both
  Surfer and GTKWave are recommended (in this order).
@whitequark whitequark force-pushed the document-simulator branch from bf905ad to baf3b73 Compare June 10, 2024 10:28
@whitequark whitequark marked this pull request as ready for review June 10, 2024 10:29
@whitequark whitequark enabled auto-merge June 10, 2024 10:30
@whitequark whitequark added this pull request to the merge queue Jun 10, 2024
Merged via the queue into amaranth-lang:main with commit 7870eb3 Jun 10, 2024
17 of 20 checks passed
@whitequark whitequark deleted the document-simulator branch June 10, 2024 10:40
@whitequark whitequark added this to the 0.5 milestone Jun 14, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

None yet

1 participant