helper function to render and hash simple detail for a specific project

Author: ewdurbin

warehouse/legacy/api/simple.py

@@ -49,6 +49,20 @@ def simple_index(request):
     return {"projects": projects}
 
 
+def _simple_detail(project, request):
+    # Get all of the files for this project.
+    files = sorted(
+        request.db.query(File)
+        .options(joinedload(File.release))
+        .join(Release)
+        .filter(Release.project == project)
+        .all(),
+        key=lambda f: (parse(f.release.version), f.filename),
+    )
+
+    return {"project": project, "files": files}
+
+
 @view_config(
     route_name="legacy.api.simple.detail",
     context=Project,
@@ -74,14 +88,4 @@ def simple_detail(project, request):
     # Get the latest serial number for this project.
     request.response.headers["X-PyPI-Last-Serial"] = str(project.last_serial)
 
-    # Get all of the files for this project.
-    files = sorted(
-        request.db.query(File)
-        .options(joinedload(File.release))
-        .join(Release)
-        .filter(Release.project == project)
-        .all(),
-        key=lambda f: (parse(f.release.version), f.filename),
-    )
-
-    return {"project": project, "files": files}
+    return _simple_detail(project, request)

warehouse/packaging/utils.py

@@ -0,0 +1,36 @@
+import hashlib
+import os.path
+
+from jinja2 import Environment, FileSystemLoader
+
+import warehouse
+
+from warehouse.legacy.api.simple import _simple_detail
+
+
+def render_simple_detail(project, request, store=False):
+    context = _simple_detail(project, request)
+
+    #  TODO: use pyramid_jinja2 "get_jinja2_environment" method instead:
+    #  https://docs.pylonsproject.org/projects/pyramid_jinja2/en/latest/api.html#pyramid_jinja2.get_jinja2_environment
+    dir_name = os.path.join(os.path.dirname(warehouse.__file__), "templates")
+    env = Environment(
+        loader=FileSystemLoader(dir_name),
+        extensions=[],
+        cache_size=0,
+    )
+
+    template = env.get_template("legacy/api/simple/detail.html")
+    content = template.render(**context, request=request)
+
+    content_hasher = hashlib.blake2b(digest_size=256 // 8)
+    content_hasher.update(content.encode("utf-8"))
+    content_hash = content_hasher.hexdigest().lower()
+    simple_detail_path = f"/simple/{project.normalized_name}/{content_hash}/"
+
+    if store:
+        #  TODO: Store generated file in FileStorage
+        #        We should probably configure a new FileStorage for a new simple-files bucket in GCS
+        pass
+
+    return (content_hash, simple_detail_path)