Allow urls for references, repos, and users

Author: object-Object

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [Pydantic's HISTORY.md](https://github.com/pydantic/pydantic/blob/main/HISTORY.md), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [UNRELEASED]
+
+### Changed
+
+* Several commands now accept a GitHub URL as input (eg. `/gh issue issue:https://github.com/object-Object/discord-github-utils/issues/1`).
+
 ## `0.2.1` - 2025-02-04
 
 ### Changed

bot/src/ghutils/utils/discord/references.py

@@ -20,12 +20,20 @@
 
 logger = logging.getLogger(__name__)
 
+URL_PATTERN = re.compile(
+    r"(?:https?://)?github.com/(?P<repo>[\w-]+/[\w-]+)/(?P<path>[\w-]+)/(?P<reference>[\w-]+)"
+)
+
 
 class ReferenceTransformer[T](Transformer, ABC):
     @property
     @abstractmethod
     def separator(self) -> str: ...
 
+    @property
+    @abstractmethod
+    def url_path(self) -> str: ...
+
     @property
     @abstractmethod
     def reference_pattern(self) -> str: ...
@@ -106,7 +114,10 @@ async def get_repo_and_reference(
         interaction: Interaction,
         value: str,
     ) -> tuple[RepositoryName, str]:
-        if self.separator in value:
+        if (match := URL_PATTERN.match(value)) and match["path"] == self.url_path:
+            raw_repo = match["repo"]
+            rest = match["reference"]
+        elif self.separator in value:
             raw_repo, rest = value.split(self.separator, maxsplit=1)
         else:
             raw_repo = ""
@@ -137,6 +148,7 @@ def build_choice(
 
 class IssueOrPRReferenceTransformer[T](ReferenceTransformer[T]):
     @property
+    @abstractmethod
     def issue_type(self) -> Literal["issue", "pr"]: ...
 
     @property
@@ -163,6 +175,10 @@ async def search_for_autocomplete(
 
 
 class IssueReferenceTransformer(IssueOrPRReferenceTransformer[Issue]):
+    @property
+    def url_path(self):
+        return "issues"
+
     @property
     def issue_type(self):
         return "issue"
@@ -183,6 +199,10 @@ async def resolve_reference(
 
 
 class PRReferenceTransformer(IssueOrPRReferenceTransformer[PullRequest]):
+    @property
+    def url_path(self):
+        return "pull"
+
     @property
     def issue_type(self):
         return "pr"
@@ -207,6 +227,10 @@ class CommitReferenceTransformer(ReferenceTransformer[Commit]):
     def separator(self):
         return "@"
 
+    @property
+    def url_path(self):
+        return "commit"
+
     @property
     def reference_pattern(self):
         return r"[0-9a-f]{5,40}"

bot/src/ghutils/utils/discord/transformers.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import logging
+import re
 
 from discord import Interaction
 from discord.app_commands import Transform, Transformer
@@ -18,8 +19,16 @@
 logger = logging.getLogger(__name__)
 
 
+REPO_URL_PATTERN = re.compile(r"(?:https?://)?github.com/(?P<value>[\w-]+/[\w-]+)")
+
+USER_URL_PATTERN = re.compile(r"(?:https?://)?github.com/(?P<value>[\w-]+)")
+
+
 class RepositoryTransformer(Transformer):
     async def transform(self, interaction: Interaction, value: str) -> FullRepository:
+        if match := REPO_URL_PATTERN.match(value):
+            value = match["value"]
+
         repo = RepositoryName.parse(value)
         async with GHUtilsBot.github_app_of(interaction) as (github, _):
             try:
@@ -41,6 +50,8 @@ async def autocomplete(  # pyright: ignore[reportIncompatibleMethodOverride]
     ) -> list[Choice[str]]:
         value = value.strip()
         if value:
+            if match := REPO_URL_PATTERN.match(value):
+                value = match["value"]
             query = f"{value} in:name fork:true"
         else:
             with GHUtilsBot.db_session_of(interaction) as session:
@@ -78,6 +89,9 @@ async def transform(
         interaction: Interaction,
         value: str,
     ) -> PrivateUser | PublicUser:
+        if match := USER_URL_PATTERN.match(value):
+            value = match["value"]
+
         async with GHUtilsBot.github_app_of(interaction) as (github, _):
             try:
                 return await gh_request(github.rest.users.async_get_by_username(value))
@@ -103,6 +117,9 @@ async def autocomplete(  # pyright: ignore[reportIncompatibleMethodOverride]
                 user = await gh_request(github.rest.users.async_get_authenticated())
                 return [Choice(name=user.login, value=user.login)]
 
+            if match := USER_URL_PATTERN.match(value):
+                value = match["value"]
+
             try:
                 result = await gh_request(
                     github.rest.search.async_users(