Wwdtm

=====

Application Changes
-------------------

* Starting with version 2.8.0 of this library, the minimum required version of the Wait Wait
Stats Database is 4.5
* Adds support for returning the NPR.org show URL with the show basic and detailed information
retrieved from the ``showurl`` column from the ``ww_shows`` database table. If ``showurl``
value is ``NULL`` in the database, a value of ``None`` will be returned

Development Changes
-------------------

* Upgrade black from 23.12.0 to 23.12.1

=====

Application Changes
-------------------

* Update type hints for parameters and return values to be more specific and to replace the use
of :py:class:`typing.Optional` and :py:class:`typing.Union` with the conventions documented in PEP-484 and PEP-604.
* Replace use of :py:class:`typing.Dict`, :py:class:`typing.List` and :py:class:`typing.Tuple` with :py:class:`dict`,
:py:class:`list` and :py:class:`tuple` respectively in type hints
* Remove use of :py:meth:`functools.lru_cache` as caching should be done by the application consuming
the library

Component Changes
-----------------

* Upgrade NumPy from 1.26.0 to 1.26.3

Development Changes
-------------------

* Switch to Ruff for code linting and formatting (with the help of Black)
* Deprecate ``perf_test.py`` for performance testing
* Upgrade pytest from 7.4.3 to 7.4.4
* Upgrade black from 23.11.0 to 23.12.0
* Upgrade wheel from 0.41.3 to 0.42.0

Documentation Changes
---------------------

* Update Sphinx configuration to be more similar to the conventions used by Pallets projects
* Change the base font from IBM Plex Sans to IBM Plex Serif
* Clean up and rewrite docstrings to be more consistent and succinct
* Add table of contents to each module page
* Update the copyright block at the top of each file to remove ``coding`` line and to include
the appropriate SPDX license identifier

=====

Application Changes
-------------------

* Change ordering of bluff information to be sorted by segment number for individual shows, or
sorted by either show ID or show date when retrieving information for multiple shows.

=====

Application Changes
-------------------

* Starting with version 2.6.0 of this library, the minimum required version of the Wait Wait
Stats Database is 4.4.
* Add support for shows that contain multiple Bluff the Listener-like segments by returning Bluff
information as a list of dictionaries. Each dictionary contains a segment number and both the
chosen and correct panelist information.

=====

**Starting with version 2.5.0, support for all versions of Python prior to 3.10 have been
deprecated.**

Application Changes
-------------------

* Remove use of ``dateutil`` from the ``show`` module as it uses methods that have been marked as
deprecated
* Replace ``dateutil.parser.parse`` with ``datetime.datetime.strptime``

Component Changes
-----------------

* Upgrade MySQL Connector/Python from 8.0.33 to 8.2.0
* Upgrade numpy from 1.24.4 to 1.26.0
* Remove python-dateutil from dependencies

Documentation Changes
---------------------

* Change Python version from 3.10 to 3.12
* Upgrade Sphinx from 6.1.2 to 7.2.6
* Upgrade sphinx-autodoc-typehints from 1.23.0 to 1.25.2
* Upgrade sphinx-toolbox from 3.4.0 to 3.5.0
* Upgrade Pallets-Sphinx-Themes from 2.0.3 to 2.1.1
* Sync up dependency versions in ``docs/requirements.txt`` with ``requirements-dev.txt``

Development Changes
-------------------

* Upgrade pytest from 7.3.1 to 7.4.3
* Upgrade black from 23.7.0 to 23.11.0
* Upgrade wheel from 0.41.2 to 0.41.3
* Upgrade build from 0.10.0 to 1.0.3
* Remove ``py38`` and ``py39`` from ``tool.black`` in ``pyproject.toml``
* Bump minimum pytest version from 7.0 to 7.4 in ``pyproject.toml``

=====

Application Changes
-------------------

* Correct the value set for show ``bluff`` value in ``Show.retrieve_all_details``, which should
return an empty dictionary and not an empty list when no Bluff the Listener data is available

Component Changes
-----------------

* Upgrade numpy from 1.24.3 to 1.24.4
* Upgrade pytz from 2023.3 to 2023.3.post1