usb-tools/amaranth
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

docs/lang: capture and verify an expected warning in doctest.

Browse source
This commit is contained in:
Catherine 2023-07-24 13:39:56 +00:00
parent 7639e84af4
commit a127167c53
1 changed files with 7 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
docs/lang.rst
View file

@ -1,3 +1,8 @@
.. testsetup::
# Required to capture warnings in doctests.
import sys; sys.stderr = sys.stdout
Language guide Language guide
############## ##############
@ -170,6 +175,8 @@ Specifying a shape with a range is convenient for counters, indexes, and all oth
.. doctest:: .. doctest::
>>> fencepost = C(256, range(256)) >>> fencepost = C(256, range(256))
<...>:1: SyntaxWarning: Value 256 equals the non-inclusive end of the constant shape range(0, 256); this is likely an off-by-one error
fencepost = C(256, range(256))
>>> fencepost.shape() >>> fencepost.shape()
unsigned(8) unsigned(8)
>>> fencepost.value >>> fencepost.value