Refactor CLI unit tests + add deprecation tests

- Move CLI unit tests to `tests/unit/cli/`
- Add initial test cases for the deprecation callback helper

Author: sirosen

tests/unit/cli/conftest.py

@@ -0,0 +1,7 @@
+import pytest
+from click.testing import CliRunner
+
+
+@pytest.fixture
+def runner() -> CliRunner:
+    return CliRunner(mix_stderr=False)

tests/unit/test_cli_annotations.py renamed to tests/unit/cli/test_annotations.py

@@ -0,0 +1,51 @@
+import click
+import pytest
+
+from check_jsonschema.cli.warnings import deprecation_warning_callback
+
+
+@click.command("foo")
+@click.option(
+    "--bar",
+    is_flag=True,
+    callback=deprecation_warning_callback("--bar", is_flag=True),
+)
+@click.option(
+    "--baz",
+    callback=deprecation_warning_callback(
+        "--baz", append_message="Use --frob instead!"
+    ),
+)
+def mycli(bar, baz):
+    print(bar)
+    if baz:
+        print(baz)
+
+
+def test_deprecation_warning_callback_on_missing_opts(runner):
+    result = runner.invoke(mycli, [])
+    assert result.exit_code == 0
+    assert result.stdout == "False\n"
+
+
+def test_deprecation_warning_callback_on_flag(runner):
+    with pytest.warns(
+        UserWarning,
+        match="'--bar' is deprecated and will be removed in a future release",
+    ):
+        result = runner.invoke(mycli, ["--bar"], catch_exceptions=False)
+    assert result.exit_code == 0, result.stdout
+    assert result.stdout == "True\n"
+
+
+def test_deprecation_warning_callback_added_message(runner):
+    with pytest.warns(
+        UserWarning,
+        match=(
+            "'--baz' is deprecated and will be removed in a future release. "
+            "Use --frob instead!"
+        ),
+    ):
+        result = runner.invoke(mycli, ["--baz", "ok"], catch_exceptions=False)
+    assert result.exit_code == 0, result.stdout
+    assert result.stdout == "False\nok\n"

tests/unit/cli/test_callbacks.py

@@ -4,7 +4,6 @@
 
 import click
 import pytest
-from click.testing import CliRunner
 
 from check_jsonschema import main as cli_main
 from check_jsonschema.cli.parse_result import ParseResult, SchemaLoadingMode
@@ -43,11 +42,6 @@ def get_ctx(*args):
         yield m
 
 
-@pytest.fixture
-def runner() -> CliRunner:
-    return CliRunner(mix_stderr=False)
-
-
 @pytest.mark.parametrize(
     "schemafile,builtin_schema,check_metaschema,expect_mode",
     [