Rename mention decorator kwarg from mention to context

Updates the kwarg passed to mention handlers from "mention" to "context"
to better reflect that it contains a MentionContext object with comment,
triggered_by, and scope fields. Also removes unused _mention_permission
attribute from MentionHandlerBase protocol.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: joshuadavidthomas

src/django_github_app/routing.py

@@ -32,7 +32,6 @@
 
 class MentionHandlerBase(Protocol):
     _mention_pattern: str | re.Pattern[str] | None
-    _mention_permission: str | None
     _mention_scope: MentionScope | None
     _mention_username: str | re.Pattern[str] | None
 
@@ -103,7 +102,7 @@ async def async_wrapper(
                             continue
                         mention.match = match
 
-                    kwargs["mention"] = MentionContext(
+                    kwargs["context"] = MentionContext(
                         comment=comment,
                         triggered_by=mention,
                         scope=event_scope,
@@ -133,7 +132,7 @@ def sync_wrapper(
                             continue
                         mention.match = match
 
-                    kwargs["mention"] = MentionContext(
+                    kwargs["context"] = MentionContext(
                         comment=comment,
                         triggered_by=mention,
                         scope=event_scope,

tests/test_routing.py

@@ -246,7 +246,7 @@ def test_multiple_decorators_on_same_function(
         @router.mention(pattern="help")
         def help_handler_help(event, *args, **kwargs):
             call_tracker.append("help decorator")
-            mention = kwargs.get("mention")
+            mention = kwargs.get("context")
             if mention and mention.triggered_by:
                 text = mention.triggered_by.text.strip()
                 if text in call_counts:
@@ -255,7 +255,7 @@ def help_handler_help(event, *args, **kwargs):
         @router.mention(pattern="h")
         def help_handler_h(event, *args, **kwargs):
             call_tracker.append("h decorator")
-            mention = kwargs.get("mention")
+            mention = kwargs.get("context")
             if mention and mention.triggered_by:
                 text = mention.triggered_by.text.strip()
                 if text in call_counts:
@@ -264,7 +264,7 @@ def help_handler_h(event, *args, **kwargs):
         @router.mention(pattern="?")
         def help_handler_q(event, *args, **kwargs):
             call_tracker.append("? decorator")
-            mention = kwargs.get("mention")
+            mention = kwargs.get("context")
             if mention and mention.triggered_by:
                 text = mention.triggered_by.text.strip()
                 if text in call_counts:
@@ -573,8 +573,8 @@ def deploy_handler(event, *args, **kwargs):
         test_router.dispatch(event, mock_gh)
 
         assert handler_called
-        assert "mention" in captured_kwargs
-        mention = captured_kwargs["mention"]
+        assert "context" in captured_kwargs
+        mention = captured_kwargs["context"]
         # Check the new structure
         assert mention.comment.body == "@bot deploy"
         assert mention.triggered_by.text == "deploy"
@@ -593,7 +593,7 @@ def test_mention_context_structure(self, test_router, get_mock_github_api_sync):
         def test_handler(event, *args, **kwargs):
             nonlocal handler_called, captured_mention
             handler_called = True
-            captured_mention = kwargs.get("mention")
+            captured_mention = kwargs.get("context")
 
         event = sansio.Event(
             {
@@ -647,7 +647,7 @@ def test_multiple_mentions_triggered_by(
         def deploy_handler(event, *args, **kwargs):
             nonlocal handler_called, captured_mention
             handler_called = True
-            captured_mention = kwargs.get("mention")
+            captured_mention = kwargs.get("context")
 
         event = sansio.Event(
             {
@@ -693,7 +693,7 @@ def test_mention_without_pattern(self, test_router, get_mock_github_api_sync):
         def general_handler(event, *args, **kwargs):
             nonlocal handler_called, captured_mention
             handler_called = True
-            captured_mention = kwargs.get("mention")
+            captured_mention = kwargs.get("context")
 
         event = sansio.Event(
             {
@@ -733,7 +733,7 @@ async def test_async_mention_context_structure(
         async def async_handler(event, *args, **kwargs):
             nonlocal handler_called, captured_mention
             handler_called = True
-            captured_mention = kwargs.get("mention")
+            captured_mention = kwargs.get("context")
 
         event = sansio.Event(
             {
@@ -774,7 +774,7 @@ def test_pattern_parameter_string(self, test_router, get_mock_github_api_sync):
         def deploy_handler(event, *args, **kwargs):
             nonlocal handler_called, captured_mention
             handler_called = True
-            captured_mention = kwargs.get("mention")
+            captured_mention = kwargs.get("context")
 
         # Should match
         event = sansio.Event(
@@ -812,7 +812,7 @@ def test_pattern_parameter_regex(self, test_router, get_mock_github_api_sync):
         def deploy_env_handler(event, *args, **kwargs):
             nonlocal handler_called, captured_mention
             handler_called = True
-            captured_mention = kwargs.get("mention")
+            captured_mention = kwargs.get("context")
 
         event = sansio.Event(
             {
@@ -895,7 +895,7 @@ def test_username_all_mentions(self, test_router, get_mock_github_api_sync):
 
         @test_router.mention(username=re.compile(r".*"))
         def all_mentions_handler(event, *args, **kwargs):
-            mention = kwargs.get("mention")
+            mention = kwargs.get("context")
             mentions_seen.append(mention.triggered_by.username)
 
         event = sansio.Event(
@@ -987,7 +987,7 @@ def test_multiple_decorators_different_patterns(
         @test_router.mention(pattern=re.compile(r"ship"))
         @test_router.mention(pattern=re.compile(r"release"))
         def deploy_handler(event, *args, **kwargs):
-            mention = kwargs.get("mention")
+            mention = kwargs.get("context")
             patterns_matched.append(mention.triggered_by.text.split()[0])
 
         event = sansio.Event(
@@ -1011,7 +1011,7 @@ def test_question_pattern(self, test_router, get_mock_github_api_sync):
 
         @test_router.mention(pattern=re.compile(r".*\?$"))
         def question_handler(event, *args, **kwargs):
-            mention = kwargs.get("mention")
+            mention = kwargs.get("context")
             questions_received.append(mention.triggered_by.text)
 
         event = sansio.Event(