Handle missing version library for /libs/library_name (boostorg#1942) (boostorg#1947)

Author: daveoconnor

config/urls.py

@@ -26,7 +26,7 @@
     RedirectToDocsView,
     RedirectToHTMLDocsView,
     RedirectToHTMLToolsView,
-    RedirectToLibraryView,
+    RedirectToLibrariesView,
     RedirectToReleaseView,
     RedirectToToolsView,
     StaticContentTemplateView,
@@ -39,6 +39,7 @@
 from libraries.views import (
     LibraryDetail,
     LibraryListDispatcher,
+    LibraryMissingVersionView,
     CommitAuthorEmailCreateView,
     VerifyCommitEmailView,
     CommitEmailResendView,
@@ -235,6 +236,11 @@
             LibraryDetail.as_view(),
             name="library-detail",
         ),
+        path(
+            "library/<boostversionslug:version_slug>/<slug:library_slug>/missing/",
+            LibraryMissingVersionView.as_view(),
+            name="library-detail-version-missing",
+        ),
         path(
             "libraries/commit_author_email_create/",
             CommitAuthorEmailCreateView.as_view(),
@@ -404,7 +410,7 @@
         ),
         re_path(
             r"^doc/libs/(?P<requested_version>[^/]+)/?$",
-            RedirectToLibraryView.as_view(),
+            RedirectToLibrariesView.as_view(),
             name="redirect-to-library-page",
         ),
         re_path(

core/views.py

@@ -900,7 +900,7 @@ def get(self, request, requested_version):
         return HttpResponseRedirect(new_path)
 
 
-class RedirectToLibraryView(BaseRedirectView):
+class RedirectToLibrariesView(BaseRedirectView):
     """View to redirect to a versioned libraries page."""
 
     def get(self, request, requested_version):

libraries/views.py

@@ -32,6 +32,7 @@
     determine_selected_boost_version,
     set_selected_boost_version,
     get_documentation_url,
+    get_prioritized_version,
     get_version_from_cookie,
 )
 from .constants import LATEST_RELEASE_URL_PATH_STR
@@ -324,22 +325,39 @@ def get_version(self):
     def dispatch(self, request, *args, **kwargs):
         """Redirect to the documentation page, if configured to."""
         if self.redirect_to_docs:
-            return redirect(
-                get_documentation_url(
-                    LibraryVersion.objects.get(
-                        library__slug=self.kwargs.get("library_slug"),
-                        version=self.get_version(),
-                    ),
-                    latest=False,
+            try:
+                library_version = LibraryVersion.objects.get(
+                    library__slug=self.kwargs.get("library_slug"),
+                    version=self.get_version(),
                 )
-            )
+            except LibraryVersion.DoesNotExist:
+                # account for the library not yet being available in this version
+                return redirect(
+                    "library-detail-version-missing",
+                    library_slug=self.kwargs.get("library_slug"),
+                    version_slug=get_prioritized_version(request),
+                )
+            return redirect(get_documentation_url(library_version, latest=False))
         response = super().dispatch(request, *args, **kwargs)
         set_selected_boost_version(
             self.kwargs.get("version_slug", LATEST_RELEASE_URL_PATH_STR), response
         )
         return response
 
 
+class LibraryMissingVersionView(BoostVersionMixin, DetailView):
+    """Display a missing library version page with proper context"""
+
+    model = Library
+    template_name = "libraries/missing_version.html"
+    slug_url_kwarg = "library_slug"
+
+    def get_context_data(self, **kwargs):
+        context = super().get_context_data(**kwargs)
+        context["library_view_str"] = get_prioritized_library_view(self.request)
+        return context
+
+
 class CommitAuthorEmailCreateView(FormView):
     template_name = "libraries/profile_commit_email_address_form.html"
     form_class = CommitAuthorEmailForm

templates/libraries/missing_version.html

@@ -0,0 +1,72 @@
+{% extends "base.html" %}
+
+{% block title %}{{ object.display_name }} - Version Not Available{% endblock %}
+{% block description %}
+    The {{ object.display_name }} library is not available in {{ selected_version.display_name }}.
+{% endblock %}
+
+{% block content %}
+  <main class="content">
+    <meta http-equiv="refresh" content="30;url={% url 'library-detail' version_slug=LATEST_RELEASE_URL_PATH_STR library_slug=object.slug %}">
+    <div class="pt-3 md:pt-4 md:pb-1 px-0 mb-0 w-full md:mb-2">
+      <div class="flex-auto mb-2 w-full">
+        <div id="overview">
+          <span class="mx-3 text-xl md:text-3xl text-orange">{{ object.display_name }}</span>
+        </div>
+      </div>
+    </div>
+
+    <section class="p-6 my-4 bg-white md:rounded-lg md:shadow-lg dark:text-white text-slate dark:bg-charcoal dark:bg-neutral-700">
+      <div class="flex items-center">
+        <i class="fas fa-exclamation-triangle text-orange mr-3 text-2xl"></i>
+        <h2 class="text-2xl">{{ object.display_name|capfirst }} Not Available for {{ selected_version.display_name }}</h2>
+      </div>
+
+      <div class="whitespace-normal mb-6">
+
+        <div class="flex justify-center mb-6 pb-4 border-b border-gray-200 dark:border-gray-600">
+          <div class="flex items-center text-blue-800 dark:text-blue-200 text-sm">
+            <i class="fas fa-clock mr-2"></i>
+            <p>
+              You will be automatically redirected to {{ object.display_name }} for the latest Boost version in
+              <span id="countdown">30</span> seconds if no option is selected.
+            </p>
+          </div>
+        </div>
+
+        <div class="flex flex-col items-center space-y-4">
+          <div>
+            <a href="{% url 'library-detail' version_slug=LATEST_RELEASE_URL_PATH_STR library_slug=object.slug %}"
+               class="inline-flex items-center px-4 py-2 bg-orange text-white rounded-md hover:bg-orange-600 transition-colors">
+              <i class="fas fa-book mr-2"></i>
+              View {{ object.display_name }} in Current Version
+            </a>
+          </div>
+
+          <div>
+            <a href="{% url 'libraries-list' version_slug=version_str library_view_str=library_view_str %}"
+               class="inline-flex items-center px-4 py-2 bg-orange text-white rounded-md hover:bg-orange-600 transition-colors">
+              <i class="fas fa-list mr-2"></i>
+              Browse All Libraries in {{ selected_version.display_name }}
+            </a>
+          </div>
+        </div>
+      </div>
+    </section>
+  </main>
+
+  <script>
+    let seconds = 30;
+    const countdownElement = document.getElementById('countdown');
+
+    const timer = setInterval(() => {
+      seconds--;
+      countdownElement.textContent = seconds;
+
+      if (seconds <= 0) {
+        clearInterval(timer);
+      }
+    }, 1000);
+
+  </script>
+{% endblock %}