Type Annotations for Before Hook

[nZac]

Summary of Changes

Despite the poorly named branch, this PR brings a brings type annotations to the before hook. The approach is a proof of concept and I'll welcome suggestions. I've not typed all the functions beneath it, just the top level API though that should be accomplished at some point. See the commit messages for more details.

Related Issues

The existing type issues are closed already, so N/A for now.

Pull Request Checklist

• [ ] Applied changes to both WSGI and ASGI code paths and interfaces (where applicable).
• [ ] Added tests for changed code.
• [ ] Prefixed code comments with GitHub nick and an appropriate prefix.
• [ ] Coding style is consistent with the rest of the framework.
• [ ] Updated documentation for changed code.
  • [ ] Added docstrings for any new classes, functions, or modules.
  • [ ] Updated docstrings for any modifications to existing code.
  • [ ] Updated both WSGI and ASGI docs (where applicable).
  • [ ] Added references to new classes, functions, or modules to the relevant RST file under docs/.
  • [ ] Updated all relevant supporting documentation files under docs/.
  • [ ] A copyright notice is included at the top of any new modules (using your own name or the name of your organization).
  • [ ] Changed/added classes/methods/functions have appropriate versionadded, versionchanged, or deprecated directives.
• [ ] Changes (and possible deprecations) have towncrier news fragments under docs/_newsfragments/, with the file name format {issue_number}.{fragment_type}.rst. (Run towncrier --draft to ensure it renders correctly.)

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 100.00%. Comparing base (9b27c71) to head (46e542c).

:exclamation: Current head 46e542c differs from pull request most recent head 22844be

Please upload reports for the commit 22844be to get more accurate results.

Additional details and impacted files

```diff @@ Coverage Diff @@ ## master #2234 +/- ## ========================================= Coverage 100.00% 100.00% ========================================= Files 63 63 Lines 6931 6896 -35 Branches 1258 1258 ========================================= - Hits 6931 6896 -35 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[CaselIT]

this was implemented in https://github.com/falconry/falcon/pull/2183

[CaselIT]

will leave a todo in the code to improve that part