Traits 7.1.0

This is a minor release of the Traits package. The most significant change is to the type
stubs, which should now be better behaved for common uses of the Instance trait type.

The following people contributed code changes and reviews for this release:

• Mark Dickinson
• Guillaume Garcia
• Ioannis Tziakos

Fixes

• Make Instance type hints more useful. (#1840)
• Remove type hints on IntEnum members. (#1856)
• Fixed subclassing support in trait-documenter. (#1866)
• Fix TraitChangeNotifyWrapper handling of compiled methods; the previous strict type
  check was causing issues with Nuitka. (#1850)
• Fix failure of clone_traits in the presence of dynamic traits. (#1846)

Tests

• Fix that we weren't actually running mypy in some of the stubs tests. (#1838)

Build

• Fix failure of python etstool.py install due to an invalid EDS dependency. (#1831)
• Fix flake8 errors resulting from redundant global statements. (#1847)
• Support Python 3.14 in CI workflows and wheel builds. (#1871)

Traits 7.0.2

This is a bugfix release of the Traits package that fixes an interoperability
issue with Pyface (a regression since Traits 6.4.3).

Fixes

• Make traits.trait_notifiers.ui_handler public again, since
  Pyface relies on importing it directly. (#1827)

Build

• Include Python 3.13 in all test workflows. (#1826)

Traits 7.0.1

This is a bugfix release of the Traits package that adjusts the wheel
building configuration. There are no non-packaging-related changes
in this release.

Changes

• Drop problematic manylinux/aarch64 wheel builds; build separate wheels
  for macOS/arm64 and macOS/x86_64. (#1822)

Traits 7.0.0

This is a major release of the Traits package. Some highlights:

• Python versions through Python 3.13 are now supported.
• The Traits package now includes (partial) type hints. (Type hints
  were previously distributed in a separate traits-stubs package.)
• There is some experimental and provisional support for async
  observer dispatch.
• Many long-deprecated pieces of functionality have finally been removed
  from the codebase.

Detailed changes

The following people contributed code changes and reviews for this release:

• Mark Dickinson
• Robert Haschke
• Chengyu Liu
• Frank Longford
• Sai Rahul Poruri
• Matt Smarte
• Corran Webster

Features

• The traits package now ships with stub files directly, instead of requiring
  those files to be installed via the separate traits-stubs package.
  (#1714)
• Experimental support for async dispatch has been added. This API should
  be considered provisional, and may change in the future. (#1771)
• Python versions through 3.13 are now supported. (#1773)
• Event types TraitChangeEvent, ListChangeEvent, DictChangeEvent
  and SetChangeEvent for the event received by observers are now
  available in traits.observation.api. This is useful for those wanting to
  use the types in type annotations. (#1805)

Changes

• The behaviour of observers using dispatch="ui" when no GUI system is
  present (in particular, if Pyface has not performed toolkit selection)
  has changed. Previously, if such an observer was triggered then
  it would raise an exception. Now it will raise with a clear error message
  if triggered from a thread other than the main thread, and will execute
  synchronously if triggered on the main thread. (#1740)
• AttributeErrors raised by some_trait_default methods are
  no longer swallowed. (#1762)
• The Date trait type no longer accepts datetime instances
  unless allow_datetime=True is used. (#1736)
• The Date, Time and Datetime trait types no longer
  accept a value of None unless allow_none=True is used. (#1736)
• Calling an interface class no longer performs implicit adaptation.
  Adaptation must be performed explicitly, using the adapt function.
  (#1719)

Removals

• Python versions earlier than 3.8 are no longer supported. (#1773)
• Removed deprecated rich_compare Trait metadata. (#1698)
• Removed deprecated find_resource and store_resource functions. (#1697)
• Removed deprecated TraitList, TraitDict and TraitTuple classes.
  (#1634)
• Removed the deprecated ability of cTrait.default_value to set the default
  value of a trait. It can now only be used for getting, not for setting.
  (#1632)
• Removed the deprecated typecode parameter to Array trait types.
  (#1633)
• Removed the deprecated nose_tools module. (#1636)
• Removed the deprecated Long, CLong, BaseLong and BaseCLong
  trait types. Use Int, CInt, BaseInt and BaseCInt instead.
  (#1701)
• Removed the deprecated TraitPrefixList and TraitPrefixMap classes.
  Use PrefixList and PrefixMap instead. (#1703)
• Removed the deprecated Function, Method and Symbol trait types.
  (#1819)
• Removed the deprecated SingletonHasTraits, SingletonHasStrictTraits
  and SingletonHasPrivateTraits classes. (#1794)
• Removed the deprecated HasTraits.get and HasTraits.set methods.
  (#1738)
• Removed the deprecated MetaHasTraits.add_listener and
  MetaHasTraits.remove_listener methods. (#1730)
• Removed the deprecated Color, RGBColor and Font traits.
  Code that needs these trait types should import them from TraitsUI instead.
  (#1737)
• Removed the deprecated trait type aliases ListInt, ListFloat,
  ListStr, ListUnicode, ListComplex, ListBool,
  ListFunction, ListMethod, ListThis, DictStrAny,
  DictStrStr, DictStrInt, DictStrFloat, DictStrBool,
  DictStrList. (#1723)
• Removed the deprecated clean_filename and clean_timestamp
  utilities. (#1820)

Fixes

• Fixed build error on Python 3.13 triggered by removal of the
  PyTRASHCAN_SAFE_BEGIN and PyTRASHCAN_SAFE_END macros. (#1767)
• Fixed warning messages from use of PyDict_GetItem in Python >= 3.13.
  (#1818)
• Fixed a race condition in test of background thread notification. (#1798)
• Fixed missing observer registration when inserting into a nested
  list. (#1761)
• Fixed a use of the deprecated datetime.datetime.utcnow method. (#1758)
• Fixed a use of a deprecated TraitsUI version check. (#1746)
• Fixed various type stubs. (#1718)

Tests

• Reworked ui_dispatch tests to no longer require Qt. (#1792)
• Removed Cython-based tests (after fixing them). (#1793, #1759)
• Fixed two tests that were triggering TraitsUI deprecation warnings. (#1790)
• Remove uses of UITester from the test suite. (#1788)
• Fix a fragile configure_traits test that could fail on warnings unrelated
  to the test goal. (#1749)

Build and continuous integration

• Added Python 3.11 to the workflow that tests wheels from PyPI. (#1715)
• Added dependabot config to aid keeping GitHub Actions up to date. (#1776)
• Brought various GitHub Actions up to date. (#1814, #1810, #1808,
  #1807, #1800, #1799, #1797, #1796, #1780, #1779, #1778, #1777)
• Removed uses of the voxmedia action for Slack notification. (#1782)
• Fix the set of architectures tested in the PyPI workflow. (#1795)
• Removed PySide as a test dependency. (#1791)
• Fixed a couple of compiler warnings related to integer conversions in the
  Windows build. (#1774)
• Temporarily pinned the Python 3.13 version to avoid an upstream bug with
  Python 3.13.0a4. (#1775, #1773)
• Updated workflows for Python 3.12 support. (#1757)
• Updated workflows for compatibility with Ubuntu 22.04. (#1727)
• Updated workflows to use Python 3.11 final. (#1725)
• Moved cibuildwheel config to pyproject.toml. (#1717)
• Temporarily pinned setuptools to avoid an incompatibility with EDM
  runtimes. (#1722)
• The PyPI release workflow has been modernized. (#1716)

Documentation

• Clarify behaviour of observers listening to attr1:attr2. (#1806)
• Fixed Trait documenter tests for Sphinx >= 7.2. (#1755)
• Fixed inconsistent spacing style in docs. (#1728)

Miscellaneous

• Copyright header updates. (#1816, #1768, #1729)
• The parser for the observe mini-language was regenerated. (#1743)

Traits 6.4.3

This is a bugfix release that fixes test failures with Sphinx 7.2 and later,
and adds support for Python 3.12.

Fixes

• Use pathlib.Path instead of sphinx.testing.path.path for Sphinx
  7.2 and later. (#1755)
• Fix uses of the deprecated datetime.utcnow method. (#1758)
• Update CI and workflows for Python 3.12 support. (#1757)

Traits 6.4.2

This is a bugfix release that fixes some test failures with the
most recent TraitsUI versions.

Fixes

• Replace a deprecated version check for TraitsUI. (#1746)
• Fix a test that fails on warnings other than those directly
  related to the test purpose. (#1749)

Traits 6.4.1

This is a bugfix release that fixes wheel builds on Python 3.11 and
fixes some distribution and testing issues with typing stubs.

Fixes

* Update `cibuildwheel` to the latest version so that we get wheels for
  Python 3.11. (#1711)
* Rename `requires_numpy_testing` decorator to `requires_numpy_typing`,
  and have it check for `numpy.typing`, not `numpy.testing`. (#1710)
* Fix missing `numpy_examples` directory in traits-stubs package data.
  (#1709)

Traits 6.4.0

Traits 6.4 is a minor feature release of Traits, which focuses mainly on typing
stub and documentation updates.

Migrating from Traits 6.3

Traits 6.4 should be largely backwards compatible with Traits 6.3, but there
are a couple of things to watch out for.

• Reminder: while the Either and Trait trait types are not yet formally
  deprecated, the intention is to eventually deprecate and remove them.
  Projects are encouraged to update their code to use Union instead.
• Similarly, any uses of the Unicode trait type in your project should
  be replaced with Str.
• Validation of items within a container (e.g., foos = List(MyTraitType))
  now always matches the validation used for the item trait at top level (e.g.,
  foo = MyTraitType). Previously, the validation methods used could differ,
  thanks to a bug in the container implementations. For most trait types this
  will make no difference, but for the Tuple trait type this change has the
  consequence that lists will no longer be accepted as valid for Tuple
  traits inside list items. See issue #1619 and PR #1625 for more information.
• Related to the above: a top-level Tuple() trait declaration currently
  accepts Python list objects, while a Tuple declaration with explicit
  item types (for example Tuple(Int(), Int())) does not. The support for
  list objects in plain Tuple() is deprecated, and will be removed in a
  future version of Traits. See PR #1627 for more information.

Detailed PR-by-PR changes

The following people contributed code changes for this release:

• Caio Agiani
• Steve Allen
• Mark Dickinson
• Sai Rahul Poruri
• Corran Webster

Features

• ETSConfig attributes now support deletion. This makes it easier to make
  temporary changes to ETSConfig attributes during unit testing. (#1670,
  #1686)
• Complex trait type validation is now more lenient: any type that
  implements __complex__ will be accepted. (#1594)
• BaseFloat validation is now more lenient, and matches Float
  validation: BaseFloat now also accepts objects whose type has an
  __index__ method. (#1595)

Changes

• An enumerate alias has been removed from traits.trait_base. In the
  unlikely event of code that imports enumerate from traits.trait_base,
  use the built-in enumerate instead. (#1681)
• Fast validation tuples int_fast_validate, float_fast_validate and
  complex_fast_validate have been removed from the traits.trait_types
  module. (#1601)

Fixes

• TraitListObject, TraitDict object and TraitSetObject now use the
  validate method of the appropriate CTrait instances to validate
  items, keys and values. Previously the handler's validate method was
  used; this gave buggy behaviour in cases where the handler's validate
  method differed from the actual validation in use. (#1625)
• Fix specification of default_value that incorrectly disregarded
  default_value_type. (#1631)
• Fix incorrect results from clone_traits applied to List, Dict
  and Set traits. (#1624)
• The find_resource and store_resource tests are now skipped
  if the pkg_resources module is not present in the environment. (#1679)
• An ETSConfig test has been renamed so that it's properly picked up
  by the test runner. (#1671)
• Fix some ETSConfig tests that assume unittest as the test runner. (#1683)
• Rename various test-related classes to avoid pytest trying to harvest test
  methods from them. (#1684)
• Overriding a default for a List or other collection trait in a subclass
  now works as expected. Previously, the behaviour was unusably buggy. (#1645)

Deprecations

• Tuple traits currently accept Python list objects in some (but
  not all) circumstances. That feature is deprecated, and will be removed
  in a future version of Traits. (#1627)

Type stubs

• Add stubs for Array, ArrayOrNone, and CArray. (#1682)
• Fix various stubs for traits.trait_types; add stubs for
  traits.ctraits. (#1661)
• Fix that TraitError stubs weren't exposed at traits.api level.
  (#1658)
• Make Int and Float type stubs more accurate. (#1656)
• Fix incorrect type stubs for the Dict trait type. (#1655)

Documentation

• Make ETSConfig class documentation visible in the API docs. (#1688)
• Add copy buttons to code samples in documentation. (#1651, #1653)
• Document Date, Datetime and Time trait types. (#1641)
• Fix some missing mentions of Set in notification docs. (#1618)
• Document the 'some_trait.-' pattern for on_trait_change. (#1592)
• Document that Either should not be used in new code. (#1699)
• Document that TraitPrefixMap and TraitPrefixList are deprecated.
  (#1702)
• Document that the Trait factory function should not be used in new code.
  (#1700)
• Miscellaneous minor fixes. (#1583, #1611, #1652, #1680)

Build and continuous integration

• Don't collect traits-stubs tests under pytest. As a result of this
  and other fixes, the test suite now passes under pytest. (#1690)
• Update etstool.py for Python 3.8 support. Python 3.8 is now the
  default Python version for builds. (#1694)
• Use PySide6 for Python >= 3.8 instead of PySide2 in CI testing. (#1685)
• Add pyproject.toml files for both Traits and traits-stubs. (#1689, #1676)
• Add Python 3.11 to some workflow runs. (#1600, #1660, #1674)
• Add Python 3.10 to install-from-PyPI workflow. (#1576)
• Allow running the main test workflow manually. (#1607)
• Switch Slack channel used to report GitHub Actions failures. (#1650)
• Exclude build directory in flake8 configuration. (#1635)
• Re-include NumPy as a test dependency on Python 3.10. (#1593)

Maintenance and refactoring

• .gitignore cleanup and updates. (#1678, #1687)
• Return PyErr_Format calls in traits/ctraits.c. (#1640)
• Update copyright header end year to 2022. (#1612)
• The ci-src-requirements.txt file isn't used; remove it. (#1602)

Traits 6.3.2

Traits 6.3.2 is a bugfix release, fixing an issue with duplicate
notifications from Property traits using the observe framework.

Fixes

• Fix that Property traits using observe metadata could be fired
  twice in subclasses. (#1587)

Traits 6.3.1

Traits 6.3.1 is a bugfix release, fixing an incompatibility between Traits 6.3.0 and Mayavi <= 4.7.3.

Fixes

• Make PrefixMap._map available again, for compatibility with Mayavi.
  (#1578)