lib.io: add a deprecation warning on Pin.eq.

This will stop working once `Pin` is no longer inheriting from
`Record`.

Author: whitequark

amaranth/lib/io.py

@@ -130,3 +130,9 @@ def __init__(self, width, dir, *, xdr=0, name=None, src_loc_at=0):
     @property
     def signature(self):
         return _pin_signature(self.width, self.dir, self.xdr)
+
+    def eq(self, other):
+        first_field, _, _ = next(iter(Pin(1, dir="o").layout))
+        warnings.warn(f"`pin.eq(...)` is deprecated; use `pin.{first_field}.eq(...)` here",
+                      DeprecationWarning, stacklevel=2)
+        return super().eq(other)