Implement Alternate Repository Location for PEP 708

tests/common/db/packaging.py

@@ -20,6 +20,7 @@
 
 from warehouse.observations.models import ObservationKind
 from warehouse.packaging.models import (
+    AlternateRepository,
     Dependency,
     DependencyKind,
     Description,
@@ -200,3 +201,13 @@ class Meta:
     )
     name = factory.Faker("pystr", max_chars=12)
     prohibited_by = factory.SubFactory(UserFactory)
+
+
+class AlternateRepositoryFactory(WarehouseFactory):
+    class Meta:
+        model = AlternateRepository
+
+    name = factory.Faker("word")
+    url = factory.Faker("uri")
+    description = factory.Faker("text")
+    project = factory.SubFactory(ProjectFactory)

tests/unit/api/test_simple.py

@@ -18,10 +18,11 @@
 from pyramid.testing import DummyRequest
 
 from warehouse.api import simple
-from warehouse.packaging.utils import API_VERSION
+from warehouse.packaging.utils import API_VERSION, _valid_simple_detail_context
 
 from ...common.db.accounts import UserFactory
 from ...common.db.packaging import (
+    AlternateRepositoryFactory,
     FileFactory,
     JournalEntryFactory,
     ProjectFactory,
@@ -48,29 +49,30 @@ def test_defaults_text_html(self, header):
         default to text/html.
         """
         request = DummyRequest(accept=header)
-        assert simple._select_content_type(request) == "text/html"
+        assert simple._select_content_type(request) == simple.MIME_TEXT_HTML
 
     @pytest.mark.parametrize(
         ("header", "expected"),
         [
-            ("text/html", "text/html"),
+            (simple.MIME_TEXT_HTML, simple.MIME_TEXT_HTML),
             (
-                "application/vnd.pypi.simple.v1+html",
-                "application/vnd.pypi.simple.v1+html",
+                simple.MIME_PYPI_SIMPLE_V1_HTML,
+                simple.MIME_PYPI_SIMPLE_V1_HTML,
             ),
             (
-                "application/vnd.pypi.simple.v1+json",
-                "application/vnd.pypi.simple.v1+json",
+                simple.MIME_PYPI_SIMPLE_V1_JSON,
+                simple.MIME_PYPI_SIMPLE_V1_JSON,
             ),
             (
-                "text/html, application/vnd.pypi.simple.v1+html, "
-                "application/vnd.pypi.simple.v1+json",
-                "text/html",
+                f"{simple.MIME_TEXT_HTML}, {simple.MIME_PYPI_SIMPLE_V1_HTML}, "
+                f"{simple.MIME_PYPI_SIMPLE_V1_JSON}",
+                simple.MIME_TEXT_HTML,
             ),
             (
-                "text/html;q=0.01, application/vnd.pypi.simple.v1+html;q=0.2, "
-                "application/vnd.pypi.simple.v1+json",
-                "application/vnd.pypi.simple.v1+json",
+                f"{simple.MIME_TEXT_HTML};q=0.01, "
+                f"{simple.MIME_PYPI_SIMPLE_V1_HTML};q=0.2, "
+                f"{simple.MIME_PYPI_SIMPLE_V1_JSON}",
+                simple.MIME_PYPI_SIMPLE_V1_JSON,
             ),
         ],
     )
@@ -80,9 +82,9 @@ def test_selects(self, header, expected):
 
 
 CONTENT_TYPE_PARAMS = [
-    ("text/html", None),
-    ("application/vnd.pypi.simple.v1+html", None),
-    ("application/vnd.pypi.simple.v1+json", "json"),
+    (simple.MIME_TEXT_HTML, None),
+    (simple.MIME_PYPI_SIMPLE_V1_HTML, None),
+    (simple.MIME_PYPI_SIMPLE_V1_JSON, "json"),
 ]
 
 
@@ -211,12 +213,15 @@ def test_no_files_no_serial(self, db_request, content_type, renderer_override):
         user = UserFactory.create()
         JournalEntryFactory.create(submitted_by=user)
 
-        assert simple.simple_detail(project, db_request) == {
+        context = {
             "meta": {"_last-serial": 0, "api-version": API_VERSION},
             "name": project.normalized_name,
             "files": [],
             "versions": [],
+            "alternate-locations": [],
         }
+        context = _update_context(context, content_type, renderer_override)
+        assert simple.simple_detail(project, db_request) == context
 
         assert db_request.response.headers["X-PyPI-Last-Serial"] == "0"
         assert db_request.response.content_type == content_type
@@ -235,13 +240,20 @@ def test_no_files_with_serial(self, db_request, content_type, renderer_override)
         db_request.matchdict["name"] = project.normalized_name
         user = UserFactory.create()
         je = JournalEntryFactory.create(name=project.name, submitted_by=user)
+        als = [
+            AlternateRepositoryFactory.create(project=project),
+            AlternateRepositoryFactory.create(project=project),
+        ]
 
-        assert simple.simple_detail(project, db_request) == {
+        context = {
             "meta": {"_last-serial": je.id, "api-version": API_VERSION},
             "name": project.normalized_name,
             "files": [],
             "versions": [],
+            "alternate-locations": sorted(al.url for al in als),
         }
+        context = _update_context(context, content_type, renderer_override)
+        assert simple.simple_detail(project, db_request) == context
 
         assert db_request.response.headers["X-PyPI-Last-Serial"] == str(je.id)
         assert db_request.response.content_type == content_type
@@ -271,7 +283,7 @@ def test_with_files_no_serial(self, db_request, content_type, renderer_override)
         user = UserFactory.create()
         JournalEntryFactory.create(submitted_by=user)
 
-        assert simple.simple_detail(project, db_request) == {
+        context = {
             "meta": {"_last-serial": 0, "api-version": API_VERSION},
             "name": project.normalized_name,
             "versions": release_versions,
@@ -289,7 +301,10 @@ def test_with_files_no_serial(self, db_request, content_type, renderer_override)
                 }
                 for f in files
             ],
+            "alternate-locations": [],
         }
+        context = _update_context(context, content_type, renderer_override)
+        assert simple.simple_detail(project, db_request) == context
 
         assert db_request.response.headers["X-PyPI-Last-Serial"] == "0"
         assert db_request.response.content_type == content_type
@@ -319,7 +334,7 @@ def test_with_files_with_serial(self, db_request, content_type, renderer_overrid
         user = UserFactory.create()
         je = JournalEntryFactory.create(name=project.name, submitted_by=user)
 
-        assert simple.simple_detail(project, db_request) == {
+        context = {
             "meta": {"_last-serial": je.id, "api-version": API_VERSION},
             "name": project.normalized_name,
             "versions": release_versions,
@@ -337,7 +352,10 @@ def test_with_files_with_serial(self, db_request, content_type, renderer_overrid
                 }
                 for f in files
             ],
+            "alternate-locations": [],
         }
+        context = _update_context(context, content_type, renderer_override)
+        assert simple.simple_detail(project, db_request) == context
 
         assert db_request.response.headers["X-PyPI-Last-Serial"] == str(je.id)
         assert db_request.response.content_type == content_type
@@ -404,7 +422,7 @@ def test_with_files_with_version_multi_digit(
         user = UserFactory.create()
         je = JournalEntryFactory.create(name=project.name, submitted_by=user)
 
-        assert simple.simple_detail(project, db_request) == {
+        context = {
             "meta": {"_last-serial": je.id, "api-version": API_VERSION},
             "name": project.normalized_name,
             "versions": release_versions,
@@ -430,7 +448,10 @@ def test_with_files_with_version_multi_digit(
                 }
                 for f in files
             ],
+            "alternate-locations": [],
         }
+        context = _update_context(context, content_type, renderer_override)
+        assert simple.simple_detail(project, db_request) == context
 
         assert db_request.response.headers["X-PyPI-Last-Serial"] == str(je.id)
         assert db_request.response.content_type == content_type
@@ -439,6 +460,15 @@ def test_with_files_with_version_multi_digit(
         if renderer_override is not None:
             assert db_request.override_renderer == renderer_override
 
+
+def _update_context(context, content_type, renderer_override):
+    if renderer_override != "json" or content_type in [
+        simple.MIME_TEXT_HTML,
+        simple.MIME_PYPI_SIMPLE_V1_HTML,
+    ]:
+        return _valid_simple_detail_context(context)
+    return context
+
     def test_with_files_quarantined_omitted_from_index(self, db_request):
         db_request.accept = "text/html"
         project = ProjectFactory.create(lifecycle_status="quarantine-enter")