[github-actions]

Added

• np.int8, np.int16, np.int32, np.uint8, np.uint16, np.uint32,
  np.uint64, np.float16, np.float32, np.complex64 and np.datetime64
  as field types, record members, collection elements and stream items,
  stored at their own width as kinds 13 to 23 of box layout 3.1 and stream
  layout 1.1. A field reads back as its numpy type, and a value that does not
  fit the width raises OverflowError. A np.datetime64 field stores
  nanoseconds since 1970. (#66)
• sbx_read_float16, sbx_write_float16, sbx_read_float32 and
  sbx_write_float32 in sharedbox_c.h. (#66)
• An array annotated X | None as a field, record member or stream item,
  holding None or an array of its sizes, as in
  scan: npt.NDArray[np.uint8] | None = field(default=None, shape=(32, 32)).
  receive_into does not fill one. (#67)
• field(capacity=...): the capacity of a box field of text, bytes,
  bytearray, Decimal or a collection, as in
  samples: list[float] = field(capacity=16). (#68)
• An array member of a dataclass or attrs record takes its sizes from
  metadata={"shape": (32, 32)} on its field. (#68)
• BoundedList[T]: a list value that keeps the stored bytes of a list field,
  as in samples: Annotated[BoundedList[float], Capacity(65536)]. It takes
  every element type list[T] takes and is stored as list[T] is. A read
  copies the bytes without decoding an element, a write of a BoundedList of
  the field's element type copies them back, indexing decodes or encodes one
  element, and a change past the capacity raises ValueError. Subclasses,
  generic or with a fixed element type, can be declared in its place. (#73)
• BoundedSet[T]: a set value that keeps the stored bytes of a set field,
  as in seen: Annotated[BoundedSet[int], Capacity(65536)]. It is stored as
  set[T] is. A read copies the bytes without decoding an element, a write
  of a BoundedSet of the field's element type copies them back, and in,
  add and remove encode one key and compare stored bytes, through an
  index after 64 lookups in a set of more than 8 elements. The set operators take any set and return a
  BoundedSet of the same class and capacity, the comparisons take any set,
  and a change past the capacity raises ValueError. A declaration raises
  TypeError for an element type whose equal values could be stored
  differently, such as Decimal or int | float. Subclasses, generic or
  with a fixed element type, can be declared in its place. (#77)
• BoundedDict[K, V]: a dict value that keeps the stored bytes of a dict
  field, as in weights: Annotated[BoundedDict[int, float], Capacity(4096)].
  It is stored as dict[K, V] is. A read copies the bytes without decoding
  an item, a write of a BoundedDict of the field's key and value types
  copies them back, and d[key], get and in encode one key and compare
  stored bytes, through an index after 64 lookups in a dict of more than 8
  keys. It keeps insertion order, | takes any mapping and returns a
  BoundedDict of the same class and capacity, and a change past the
  capacity raises ValueError. Keys follow the rules of BoundedSet
  elements, and values can be of any type a dict field holds. Subclasses,
  generic or with fixed key and value types, can be declared in its place. (#82)
• BoundedList of int, float, bool, complex or NumPy integer, float,
  complex or bool_ elements supports the buffer protocol: np.asarray(value)
  and memoryview(value) share its elements without decoding them, read only
  for bool and bool_, and a change of length raises BufferError while
  such a view exists. (#85)

Changed

• Reading a list, tuple, set, frozenset or dict field allocates and
  copies less, and reading a record whose class takes every member by position
  no longer builds a dict of keyword arguments. (#65)
• A union stores a number through its first member of the same kind of
  number, so np.int64(5) written to float | int reads back as 5. (#66)
• int, float, complex and bool fields take numpy's integer, floating,
  complex and bool scalars, and read back the Python type. np.int64,
  np.float64, np.complex128 and np.bool_ fields read back as those types
  and hash as int, float, complex and bool. (#66)
• The extension is compiled for speed instead of size. Writing a list, set
  or dict field, and reading, indexing or looking up a BoundedList or
  BoundedSet, take less time. The wheels are about 75 KB larger on Linux and
  17 KB larger on Windows. (#79)

Fixed

• A list, set or dict whose slots end short of its alignment, such as
  Annotated[list[Color], Capacity(3)] for an Enum Color, is accepted;
  its size is rounded up to the alignment. sharedbox 0.6 refuses a segment
  that holds one. (#66)
• A TypeError about the sizes of an array member of a dataclass or attrs
  record names its metadata shape, as in metadata shape (3), instead of
  field(shape=...). (#70)

[codspeed]

Merging this PR will not alter performance

✅ 87 untouched benchmarks
⏩ 1 skipped benchmark¹

---

_{Comparing release/v0.7.0 (02fb863) with main (e7aaa11)}

Footnotes

1. 1 benchmark was skipped, so the baseline result was used instead. If it was deleted from the codebase, click here and archive it to remove it from the performance reports. ↩