Version 2.21.1

Application Changes

• Add score_exception to panelist appearance details across the board
  • The score_exception is a boolean flag that is set to True if the total score does not equal the sum of the starting score and the number of correct answers doubled
  • Exceptions can happen due to bonus points available in shows from 1998, an incorrect calculation or statement when the scorekeeper announces a panelist's score

Pull Request(s): #98

Full Changelog: v2.21.0...v2.21.1

Version 2.21.0

Application Changes

• Raised the minimum supported version of Python from 3.10 to 3.12
  • Updated project.requires-python from >=3.10 to >=3.12
  • Updated tools.ruff.target-version from py310 to py312 in pyproject.toml
  • Replaced Python 3.10 and 3.11 with Python 3.13 and 3.14 in project.classifiers
• Added provisional support for MariaDB Server 11.8 (LTS) and 12 (rolling release)
  • Compatibility and support for MariaDB Server 12 is slightly experimental due to MariaDB Server 12 being a rolling release
  • Compatibility and support for MariaDB Server prior to version 11.8 is not provided or guaranteed

Component Changes

• Upgraded MySQL Connector/Python from 9.1.0 to 9.4.0
• Upgraded NumPy from 2.2.6 to 2.3.3

Development Changes

• Added twine version 6.2.0
• Upgraded Ruff from 0.12.8 to 0.13.3

Documentation Changes

• Matched the same upgrades as listed in Component Changes and Development Changes
• Added Matplotlib version 3.10.5
• Upgraded furo from 2024.8.6 to 2025.9.25
• Upgraded pytest from 8.3.6 to 8.4.1
• Upgraded Sphinx from 8.1.3 to 8.2.3
• Upgraded sphinx-autodoc-typehint from 2.5.0 to 3.2.0
• Upgraded sphinx-toolbox from 3.8.1 to 4.0.0
• Upgraded sphinxext-opengraph from 0.9.1 to 0.12.0
• Added a "Versioning" section to index page

Pull Request(s): #97

Full Changelog: v2.20.0...v2.21.0

2.20.0

Application Changes

• Added is_host, is_panelist and is_scorekeeper keys for all returned guest details with boolean values whether a Not My Job guest has also been a host, panelist or scorekeeper
• Added is_guest, is_panelist and is_scorekeeper keys for all returned host details with boolean values whether a host has also been a Not My Job guest, panelist or scorekeeper
• Added is_guest, is_host and is_scorekeeper keys for all returned panelist details with boolean values whether a panelist has also been a guest, host or scorekeeper
• Added is_guest, is_host and is_panelist keys for all returned scorekeeper details with boolean values whether a scorekeeper has also been a guest, host or panelist
• Added tests for one of the three newly added keys for guests, hosts, panelists and scorekeeper
• Changed incorrect references to ID to slug string in test assertion messages

Component Changes

• Upgrade NumPy from 2.1.2 to 2.2.6

Development Changes

• Upgrade Ruff from 0.11.9 to 0.12.8
• Upgrade pytest from 8.3.5 to 8.4.1
• Upgrade pytest-cov from 6.1.1 to 6.2.1
• Upgrade build from 1.2.2.post1 to 1.3.0

Pull Request(s): #95

Full Changelog: v2.19.0...v2.20.0

Version 2.19.0

Application Changes

• Add :py:meth:wwdtm.show.Show.retrieve_random_date_object to retrieve a random show date as a :py:class:datetime.time object
• Add :py:meth:wwdtm.show.Show.retrieve_random_date_object_by_year to retrieve a random show date as a :py:class:datetime.time object for a specific year
• Add tests for both new methods

Development Changes

• Upgrade ruff from 0.9.3 to 0.11.9
• Upgrade pytest from 8.3.3 to 8.3.5
• Upgrade pytest-cov from 5.0.0 to 6.1.1
• Upgrade wheel from 0.44.0 to 0.45.1

Documentation Changes

• Upgrade pytest from 8.3.3 to 8.3.5
• Remove black from dependencies
• Update environment.yaml file to match library dependencies
• Replace the word "given" with "specific" in method docstrings

Pull Request(s): #92

Full Changelog: v2.18.2...v2.19.0

Version 2.18.2

Application Changes

• Add inclusive named parameter to the following methods to determine whether repeat shows are included with Best Of shows, or whether Best Of shows included with repeat shows. Default value in all cases is True.
  • :py:meth:wwdtm.show.Show.retrieve_all_best_ofs
  • :py:meth:wwdtm.show.Show.retrieve_all_best_ofs_details
  • :py:meth:wwdtm.show.Show.retrieve_all_repeats
  • :py:meth:wwdtm.show.Show.retrieve_all_repeats_details
  • :py:meth:wwdtm.show.Show.retrieve_best_ofs_by_year
  • :py:meth:wwdtm.show.Show.retrieve_best_ofs_details_by_year
  • :py:meth:wwdtm.show.Show.retrieve_repeats_by_year
  • :py:meth:wwdtm.show.Show.retrieve_repeats_details_by_year

Pull Request(s): #91

Full Changelog: v2.18.1...v2.18.2

Version 2.18.1

Application Changes

• Adding the following methods to be used in an upcoming version of the Wait Wait Stats page:
  • :py:meth:wwdtm.show.Show.retrieve_best_ofs_by_year
  • :py:meth:wwdtm.show.Show.retrieve_best_ofs_details_by_year
  • :py:meth:wwdtm.show.Show.retrieve_repeat_best_ofs_by_year
  • :py:meth:wwdtm.show.Show.retrieve_repeat_best_ofs_details_by_year
  • :py:meth:wwdtm.show.Show.retrieve_repeats_by_year
  • :py:meth:wwdtm.show.Show.retrieve_repeats_details_by_year
• Adding inclusive parameter to :py:meth:wwdtm.show.Show.retrieve_counts_by_year to flag whether or not Best Of shows are included in repeat show counts (default: False)

Pull Request(s): #90

Full Changelog: v2.18.0...v2.18.1

Version 2.18.0

Application Changes

• Adding :py:meth:wwdtm.show.Show.retrieve_counts_by_year to retrieve a count of regular, Best Of, repeat, repeat Best Of and a total count of shows
• Adding :py:meth:wwdtm.show.Show.retrieve_all_counts_by_year to retrieve a count of regular, Best Of, repeat, repeat Best Of and a total count of shows for all years, grouped by year

Component Changes

• Upgrade pytz from 2024.2 to 2025.2

Pull Request(s): #89

Full Changelog: v2.17.2...v2.18.0

Version 2.17.2

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

Pull Request(s): #88

Full Changelog: v2.17.1...v2.17.2

Version 2.17.1

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

Pull Request(s): #87

Full Changelog: v2.17.0...v2.17.1

Version 2.17.0

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

Pull Request(s): #86

Full Changelog: v2.16.1...v2.17.0