Minor wire_struct improvements:

* The concatenated value can be set with the special `kwarg` "_value". This is
  useful when the `wire_struct`'s class name is not known.

* Changes to make `wire_structs` documentable with Sphinx. The generated class
  copies documentation from the decorated class (`__doc__`), and the generated
  class's name now matches the decorated class's name. Previously all
  `wire_struct` classes were named `_WireStruct`.

* Add a new `class_name` argument to `wire_matrix`. This lets users set the
  name of the generated class. This is optional for backwards compatibility,
  but highly recommended to help with debugging. Previously all `wire_matrix`
  classes were named `_WireMatrix`.

Author: fdxmw

examples/Makefile

@@ -1,4 +1,4 @@
-PYTHON=python
+PYTHON=uv run python3
 PY_FILES=$(wildcard *.py)
 IPYNB_FILES=$(addprefix ../ipynb-examples/, $(PY_FILES:.py=.ipynb))
 

examples/example1.2-wire-struct.py

@@ -154,7 +154,7 @@ class Pixel:
 # `PixelPair` is a pair of two `Pixels`. This also shows how `wire_matrix()` and
 # `wire_struct` work together - `PixelPair` is a `wire_struct` nested in a
 # `wire_matrix()`.
-PixelPair = pyrtl.wire_matrix(component_schema=Pixel, size=2)
+PixelPair = pyrtl.wire_matrix(component_schema=Pixel, size=2, class_name="PixelPair")
 
 # `wire_matrix()` returns a class!
 assert inspect.isclass(PixelPair)

ipynb-examples/example1.2-wire-struct.ipynb

@@ -384,7 +384,7 @@
    },
    "outputs": [],
    "source": [
-    "PixelPair = pyrtl.wire_matrix(component_schema=Pixel, size=2)\n"
+    "PixelPair = pyrtl.wire_matrix(component_schema=Pixel, size=2, class_name=\"PixelPair\")\n"
    ]
   },
   {