v22.2.0

Compare Source

Backwards-incompatible Changes

• Python 3.5 is not supported anymore.
  #​988

Deprecations

• Python 3.6 is now deprecated and support will be removed in the next release.
  #​1017

Changes

• attrs.field() now supports an alias option for explicit __init__ argument names.

  Get __init__ signatures matching any taste, peculiar or plain!
  The PEP 681 compatible alias option can be use to override private attribute name mangling, or add other arbitrary field argument name overrides.
  #​950

• attrs.NOTHING is now an enum value, making it possible to use with e.g. typing.Literal.
  #​983

• Added missing re-import of attr.AttrsInstance to the attrs namespace.
  #​987

• Fix slight performance regression in classes with custom __setattr__ and speedup even more.
  #​991

• Class-creation performance improvements by switching performance-sensitive templating operations to f-strings.

  You can expect an improvement of about 5% -- even for very simple classes.
  #​995

• attrs.has() is now a TypeGuard for AttrsInstance.
  That means that type checkers know a class is an instance of an attrs class if you check it using attrs.has() (or attr.has()) first.
  #​997

• Made attrs.AttrsInstance stub available at runtime and fixed type errors related to the usage of attrs.AttrsInstance in Pyright.
  #​999

• On Python 3.10 and later, call abc.update_abstractmethods() on dict classes after creation.
  This improves the detection of abstractness.
  #​1001

• attrs's pickling methods now use dicts instead of tuples.
  That is safer and more robust across different versions of a class.
  #​1009

• Added attrs.validators.not_(wrapped_validator) to logically invert wrapped_validator by accepting only values where wrapped_validator rejects the value with a ValueError or TypeError (by default, exception types configurable).
  #​1010

• The type stubs for attrs.cmp_using() now have default values.
  #​1027

• To conform with PEP 681, attr.s() and attrs.define() now accept unsafe_hash in addition to hash.
  #​1065