Wwdtm

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

* Added missing ``use_decimal_scores`` method parameter to :py:meth:`wwdtm.panelist.Panelist.retrieve_random_details`

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

* Updated test for :py:meth:`wwdtm.panelist.Panelist.retrieve_random_details` to including passing in values for ``use_decimal_scores``

======

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

* Added missing ``include_decimal_scores`` method parameter to :py:meth:`wwdtm.show.Show.retrieve_random_details` and :py:meth:`wwdtm.show.Show.retrieve_random_details_by_year` and passthrough to :py:meth:`wwdtm.show.Show.retrieve_details_by_id`

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

* Updated tests for :py:meth:`wwdtm.show.Show.retrieve_random_details` and :py:meth:`wwdtm.show.Show.retrieve_random_details_by_year` to including passing in values for the corresponding ``include_decimal_scores`` parameters

======

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

* Added the following methods to :py:class:`wwdtm.show.Show` to extend the random show feature

* :py:meth:`wwdtm.show.Show.retrieve_random_id_by_year`
* :py:meth:`wwdtm.show.Show.retrieve_random_date_by_year`
* :py:meth:`wwdtm.show.Show.retrieve_random_by_year`
* :py:meth:`wwdtm.show.Show.retrieve_random_details_by_year`

======

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

* Fix coding issue within :py:meth:`wwdtm.location.Location.retrieve_postal_details_by_abbreviation`

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

* Added missing tests for postal abbreviation methods in :py:class:`wwdtm.location.Location`

======

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

* Add ``retrieve_random()``, ``retrieve_random_id()``, ``retrieve_random_slug()``, ``retrieve_random_date()`` and ``retrieve_random_details()`` to the following classes that mirror the corresponding feature in the `Wait Wait Stats Page`_

* :py:class:`wwdtm.guest.Guest`
* :py:class:`wwdtm.host.Host`
* :py:class:`wwdtm.location.Location`
* :py:class:`wwdtm.panelist.Panelist`
* :py:class:`wwdtm.scorekeeper.Scorekeeper`
* :py:class:`wwdtm.show.Show`

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

* Add corresponding tests for the new series of retrieve random items
* Fixed typos in docstrings or testing assertion messages

======

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

* Change SQL joins from ``JOIN`` to ``LEFT JOIN`` in :py:class:`wwdtm.location.Location` to properly handle ``NULL`` values in the ``state`` column
* Add :py:meth:`wwdtm.location.Location.retrieve_postal_abbreviations` that returns postal abbreviations and their corresponding names and countries

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

* Upgrade ruff from 0.7.0 to 0.9.3
* Remove black from required development packages as part of migrating entirely to Ruff
* Ran ``ruff format`` to format Python code files using the Ruff 2025 Style Guide