add Installation manager method for creating from GH API data

Author: joshuadavidthomas

CHANGELOG.md

@@ -18,6 +18,10 @@ and this project attempts to adhere to [Semantic Versioning](https://semver.org/
 
 ## [Unreleased]
 
+### Added
+
+- Added `Installation.objects.acreate_from_gh_data`/`Installation.objects.create_from_gh_data` manager methods.
+
 ## [0.1.0]
 
 ### Added

README.md

@@ -249,6 +249,7 @@ async with AsyncGitHubAPI(installation_id=installation.installation_id) as gh:
 ##### Manager methods
 
 - `acreate_from_event`/`create_from_event`: Create from installation events _(primarily for internal use)_
+- `acreate_from_gh_data`/`create_from_gh_data`: Create from GitHub API response data _(primarily for internal use)_
 - `aget_from_event`/`get_from_event`: Retrieve installation from webhook events (`gidgethub.sansio.Event`)
 
 ##### Model methods

src/django_github_app/models.py

@@ -64,34 +64,26 @@ def action(self) -> str | None:
 
 class InstallationManager(models.Manager["Installation"]):
     async def acreate_from_event(self, event: sansio.Event):
-        installation_data = event.data["installation"]
-
-        app_id = installation_data["app_id"]
+        app_id = event.data["installation"]["app_id"]
 
         if str(app_id) == app_settings.APP_ID:
-            installation = await self.acreate(
-                installation_id=installation_data["id"],
-                data=installation_data,
-            )
-
-            repository_data = event.data["repositories"]
+            installation = await self.acreate_from_gh_data(event.data["installation"])
 
-            repositories = [
-                Repository(
-                    installation=installation,
-                    repository_id=repository["id"],
-                    repository_node_id=repository["node_id"],
-                    full_name=repository["full_name"],
-                )
-                for repository in repository_data
-            ]
-            await Repository.objects.abulk_create(repositories)
+            await Repository.objects.acreate_from_gh_data(
+                event.data["repositories"], installation
+            )
 
             return installation
 
     def create_from_event(self, event: sansio.Event):
         return async_to_sync(self.acreate_from_event)(event)
 
+    async def acreate_from_gh_data(self, data: dict[str, str]):
+        return await self.acreate(installation_id=data["id"], data=data)
+
+    def create_from_gh_data(self, data: dict[str, str]):
+        return async_to_sync(self.acreate_from_gh_data)(data)
+
     async def aget_from_event(self, event: sansio.Event):
         try:
             installation_id = event.data["installation"]["id"]

tests/test_models.py

@@ -160,6 +160,31 @@ def test_create_from_event(self, create_event, override_app_settings):
             repositories
         )
 
+    @pytest.mark.asyncio
+    async def test_acreate_from_gh_data(self):
+        installation_data = {
+            "id": seq.next(),
+            "app_id": seq.next(),
+        }
+
+        installation = await Installation.objects.acreate_from_gh_data(
+            installation_data
+        )
+
+        assert installation.installation_id == installation_data["id"]
+        assert installation.data == installation_data
+
+    def test_create_from_gh_data(self):
+        installation_data = {
+            "id": seq.next(),
+            "app_id": seq.next(),
+        }
+
+        installation = Installation.objects.create_from_gh_data(installation_data)
+
+        assert installation.installation_id == installation_data["id"]
+        assert installation.data == installation_data
+
     @pytest.mark.asyncio
     async def test_aget_from_event(self, ainstallation, create_event):
         installation = await ainstallation