Add project releases RSS feed (#7013)

* Add project releases RSS feed

Closes #1683

* Add authors to project releases RSS feeds

* Add project releases RSS feed docs

* Move project releases feed to /rss/project/{name}/releases.xml

* Rename package releases feed to project releases feed in docs

* Improve project rss feed example rendering

Co-authored-by: Dustin Ingram <[email protected]>

* Use descending release date order in RSS feeds

Co-authored-by: Dustin Ingram <[email protected]>

* Don't overwrite base feeds, provide for adding instead

Co-authored-by: Dustin Ingram <[email protected]>

* Don't overwrite base feeds, provide for adding instead

Co-authored-by: Dustin Ingram <[email protected]>

* Don't overwrite base feeds, provide for adding instead

Co-authored-by: Dustin Ingram <[email protected]>

* Test project releases RSS feed ordering

Co-authored-by: Dustin Ingram <[email protected]>

* Test project releases RSS feed ordering

Co-authored-by: Dustin Ingram <[email protected]>

* Add RSS feed link to release history tab

Co-authored-by: Dustin Ingram <[email protected]>

* Update tests/unit/rss/test_views.py

* Update translations

Co-authored-by: Dustin Ingram <[email protected]>

Author: scop

docs/api-reference/feeds.rst

@@ -1,8 +1,9 @@
 Feeds
 =====
 
-PyPI offers two RSS feeds, the `Newest Packages Feed`_ and the `Latest Updates
-Feed`_. You can also call its APIs to get more details on project activity.
+PyPI offers three RSS feeds, the `Newest Packages Feed`_, the `Latest Updates
+Feed`_, and the `Project Releases Feed`_. You can also call its APIs to get
+more details on project activity.
 
 
 Newest Packages Feed
@@ -21,6 +22,15 @@ newly created releases for individual projects on PyPI, including the project
 name and description, release version, and a link to the release page.
 
 
+Project Releases Feed
+---------------------
+
+Available at ``https://pypi.org/rss/project/<project_name>/releases.xml`` for each
+project, this feed provides the latest releases for the given project on
+PyPI, including the package name and description, release version, and a link
+to the release page.
+
+
 Project and release activity details
 ------------------------------------
 

tests/unit/rss/test_views.py

@@ -73,6 +73,35 @@ def test_rss_packages(db_request):
     assert db_request.response.content_type == "text/xml"
 
 
+def test_rss_project_releases(db_request):
+    db_request.find_service = pretend.call_recorder(
+        lambda *args, **kwargs: pretend.stub(
+            enabled=False, csp_policy=pretend.stub(), merge=lambda _: None
+        )
+    )
+
+    db_request.session = pretend.stub()
+
+    project = ProjectFactory.create()
+
+    release_v1 = ReleaseFactory.create(project=project, version="1.0.0")
+    release_v1.created = datetime.date(2018, 1, 1)
+    release_v3 = ReleaseFactory.create(project=project, version="3.0.0")
+    release_v3.created = datetime.date(2019, 1, 1)
+    release_v2 = ReleaseFactory.create(project=project, version="2.0.0")
+    release_v2.created = datetime.date(2020, 1, 1)
+
+    release_v3.author_email = "[email protected]"
+
+    assert rss.rss_project_releases(project, db_request) == {
+        "project": project,
+        "latest_releases": tuple(
+            zip((release_v2, release_v3, release_v1), (None, "[email protected]", None))
+        ),
+    }
+    assert db_request.response.content_type == "text/xml"
+
+
 def test_format_author(db_request):
     db_request.find_service = pretend.call_recorder(
         lambda *args, **kwargs: pretend.stub(

tests/unit/test_routes.py

@@ -303,6 +303,14 @@ def add_policy(name, filename):
         pretend.call("ses.hook", "/_/ses-hook/", domain=warehouse),
         pretend.call("rss.updates", "/rss/updates.xml", domain=warehouse),
         pretend.call("rss.packages", "/rss/packages.xml", domain=warehouse),
+        pretend.call(
+            "rss.project.releases",
+            "/rss/project/{name}/releases.xml",
+            factory="warehouse.packaging.models:ProjectFactory",
+            traverse="/{name}/",
+            read_only=True,
+            domain=warehouse,
+        ),
         pretend.call("legacy.api.simple.index", "/simple/", domain=warehouse),
         pretend.call(
             "legacy.api.simple.detail",