[a-hurst]

PR Description

This PR adds a new module (KLQueries) for easily prompting and validating keyboard input from users. This was previously technically possible with horrendous abuse of the query function in KLCommunications (or adding custom 'experimental' queries to the user_queries.json file), but this module provides the same functionality (and more) with a much cleaner and simpler API.

Currently, the KLQueries module provides 3 Query classes: NumberQuery, ChoiceQuery, and TextQuery, each for different types of responses. NumberQueries ensure that the user's response is numeric and enforces upper and lower bounds on the response. ChoiceQueries are for multiple-choice queries and ensure the response is one of a set of possible options, and TextQueries are for free-form text responses (with optional limits on the minimum/maximum number of characters). The module also provides the QueryStyle class for customizing the location and appearance of queries.

A FormatQuery class that requires responses follow a regex-style format (e.g. "P###") is planned for the future.

In addition to the new module itself, the blit function has also been fully re-documented with a proper explanation of the location and registration parameter, which was necessary in order to reference the explanation in the documentation for QueryStyle.

This PR is intended to completely remove the need for KLCommunication.query from the public API (currently only used in BaseballTOJ and TraceLab) and lay the groundwork for replacinguser_queries.json itself with a more flexible and more readable pure-Python equivalent.

Merge Checklist

• the PR has been reviewed and all comments are resolved
• all CI checks pass
• (if applicable): the PR description includes the phrase closes #<issue-number> to automatically close an issue
• (if applicable): bug fixes, new features, or API changes are documented in CHANGELOG.rst