Skip to content

rtllib documentation cleanup#491

Open
fdxmw wants to merge 4 commits into
UCSBarchlab:developmentfrom
fdxmw:trace
Open

rtllib documentation cleanup#491
fdxmw wants to merge 4 commits into
UCSBarchlab:developmentfrom
fdxmw:trace

Conversation

@fdxmw

@fdxmw fdxmw commented Jun 29, 2026

Copy link
Copy Markdown
Contributor
  • Add AES doctest examples.
  • Make AES method names more consistent. Forward calls to the deprecated old method names to the new method names.
  • Convert PRNG examples to doctest examples.

Also:

  • Update PRNGs to use State Registers.
  • Include render_trace output directly in examples.
  • render_trace: Remove trailing whitespace from output.
  • Always use the pyrtl. package prefix in examples.
  • Add more documentation links to specific examples/.
  • Stop publishing documentation for:
    • half_adder, one_bit_add, ripple_add, ripple_half_add (undocumented)
    • testingutils (nondeterministic tests are generally a bad idea)

* Add AES doctest examples.
* Make AES method names more consistent. Forward calls to the deprecated old
  method names to the new method names.
* Convert PRNG examples to doctest examples.

Also:

* Update PRNGs to use State Registers.
* Include `render_trace` output directly in examples.
* `render_trace`: Remove trailing whitespace from output.
* Always use the `pyrtl.` package prefix in examples.
* Add more documentation links to specific `examples/`.
* Stop publishing documentation for:
  * half_adder, one_bit_add, ripple_add, ripple_half_add (undocumented)
  * testingutils (nondeterministic tests are generally a bad idea)
@codecov

codecov Bot commented Jun 29, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 95.23810% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 92.2%. Comparing base (443e47e) to head (0eb29ed).

Files with missing lines Patch % Lines
pyrtl/visualization.py 0.0% 1 Missing ⚠️
Additional details and impacted files
@@              Coverage Diff              @@
##           development    #491     +/-   ##
=============================================
+ Coverage         92.2%   92.2%   +0.1%     
=============================================
  Files               30      30             
  Lines             7441    7450      +9     
=============================================
+ Hits              6855    6865     +10     
+ Misses             586     585      -1     

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

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

fdxmw added 2 commits June 29, 2026 10:25
…, and add

a comment. The example shouldn't be doctested because it depends on Yosys,
which may not be installed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant