mild CLI cleanup

[aaazzam]

In the spirit of #15008 and #16292, this PR

• adds an explicit acommand method to Prefect's Typer subclass to handle asynchronous CLI commands.
• removes some method overrides that obfuscated typing and incorrectly forwarded kwargs to the relevant super().
  • In particular, removes our custom deprecation handling (which wasn't hooked up correctly), and follow's Typer's guidance on how to report deprecation dates (put it in the docstring).
• eschews some DRY-driven methods in favor of some explicit RY code (e.g. just register aliases directly).

This PR started getting big, so going to cap it here.

That said, some advances in Click/Typer/Pydantic since this was last touched obviates some of our design.

• I'm interested in finding a way to use Click's LazyGroups to do lazy loading so that import time doesn't scale with the number of subcommands.

Aside from that, the directory structure should be revisited: the main app is defined in cli/root.py then imported into cli/__init__.py from which every file in cli imports that app and then attaches its local app to it. tl;dr couldn't get more circular if we tried.

Given more time, I'd refactor into a single app.py that takes on responsibility for importing and doing the attaching and registration. Makes it easy to inspect the command space and ensure aliasing is done properly, etc.

[codspeed-hq]

CodSpeed Performance Report

Merging #16560 will not alter performance

_{Comparing cleanup-cli (92f7a88) with main (5f5e4a6)}

Summary

✅ 3 untouched benchmarks