Proxito: browndate for redirecting / to README.html

Related #9993

Author: humitos

readthedocs/proxito/views/serve.py

@@ -41,6 +41,7 @@
     ServeRedirectMixin,
     StorageFileNotFound,
 )
+from readthedocs.proxito.views.utils import allow_readme_html_at_root_url
 from readthedocs.redirects.exceptions import InfiniteRedirectException
 from readthedocs.storage import build_media_storage
 
@@ -641,12 +642,16 @@ def _get_index_file_redirect(self, request, project, version, filename, full_pat
         - /en/latest/foo -> /en/latest/foo/README.html
         - /en/latest/foo/ -> /en/latest/foo/README.html
         """
-        tryfiles = ["index.html", "README.html"]
-        # If the path ends with `/`, we already tried to serve
-        # the `/index.html` file, so we only need to test for
-        # the `/README.html` file.
-        if full_path.endswith("/"):
-            tryfiles = ["README.html"]
+
+        if allow_readme_html_at_root_url():
+            tryfiles = ["index.html", "README.html"]
+            # If the path ends with `/`, we already tried to serve
+            # the `/index.html` file, so we only need to test for
+            # the `/README.html` file.
+            if full_path.endswith("/"):
+                tryfiles = ["README.html"]
+        else:
+            tryfiles = ["index.html"]
 
         tryfiles = [
             (filename.rstrip("/") + f"/{tryfile}").lstrip("/") for tryfile in tryfiles

readthedocs/proxito/views/utils.py

@@ -1,4 +1,8 @@
+import datetime
+
+import pytz
 import structlog
+from django.conf import settings
 from django.http import HttpResponse
 from django.shortcuts import render
 
@@ -56,3 +60,22 @@ def proxito_404_page_handler(
     )
     r.status_code = http_status
     return r
+
+
+def allow_readme_html_at_root_url():
+    tzinfo = pytz.timezone("America/Los_Angeles")
+    now = datetime.datetime.now(tz=tzinfo)
+
+    # Brownout dates as published in https://about.readthedocs.com/blog/2024/05/readme-html-deprecated/
+    # fmt: off
+    return not any([
+        # 12 hours browndate
+        datetime.datetime(2024, 6, 10, 0, 0, 0, tzinfo=tzinfo) < now < datetime.datetime(2024, 6, 10, 12, 0, 0, tzinfo=tzinfo),
+        # 24 hours browndate
+        datetime.datetime(2024, 6, 17, 0, 0, 0, tzinfo=tzinfo) < now < datetime.datetime(2024, 6, 18, 0, 0, 0, tzinfo=tzinfo),
+        # 48 hours browndate
+        datetime.datetime(2024, 6, 24, 0, 0, 0, tzinfo=tzinfo) < now < datetime.datetime(2024, 6, 26, 0, 0, 0, tzinfo=tzinfo),
+        # Deprecated after July 1st
+        datetime.datetime(2024, 7, 1, 0, 0, 0, tzinfo=tzinfo) < now,
+    ]) and settings.RTD_ENFORCE_BROWNOUTS_FOR_DEPRECATIONS
+    # fmt: on