Enhance tools functionality in Boost library

- Added a new tool "boostlook" to the TOOLS constant in constants.py with its description and URL.
- Modified the get_tools function in utils.py to accept an optional version parameter, allowing for dynamic URL generation for version-specific tools.
- Updated LibraryListBase and LibraryCategorized views to pass the selected version to get_tools, ensuring correct URL handling in the context data.

Author: julioest

libraries/constants.py

@@ -370,46 +370,54 @@
 
 RELEASE_REPORT_AUTHORS_PER_PAGE_THRESHOLD = 6
 TOOLS = [
+    {
+        "name": "boostlook",
+        "description": "A CSS framework for Boost C++ Library documentation.",
+        "url_path": "https://github.com/boostorg/boostlook",
+        "version_specific": False,
+    },
     {
         "name": "Boost.Build",
         "slug": "build",
         "description": "The Boost build system, including the full Boost version of the jam sources.",
-        "url": "libs/latest/tools/build/doc/html/index.html",
+        "version_specific": True,
+        "url_path": "tools/build/doc/html/index.html",
     },
     {
         "name": "Regression",
-        "slug": "regression",
         "description": "The Boost regression testing system reporting sources.",
-        "url": "tools/regression/index.html",
+        "url_path": "https://www.boost.org/doc/contributor-guide/testing/regression-tests.html",
+        "version_specific": False,
     },
     {
         "name": "Inspect",
-        "slug": "inspect",
         "description": "The inspection tool used to detect errors in the Boost directory hierarchy.",
-        "url": "tools/inspect/index.html",
+        "version_specific": True,
+        "url_path": "tools/inspect/index.html",
     },
     {
         "name": "BoostBook",
-        "slug": "boostbook",
         "description": "A Boost documentation system, based on DocBook and the Extensible Stylesheet Language (XSL), used by some Boost libraries.",
-        "url": "tools/boostbook/index.html",
+        "version_specific": True,
+        "url_path": "tools/boostbook/index.html",
     },
     {
         "name": "bcp",
-        "slug": "bcp",
         "description": "A utility to extract subsets of Boost; to determine which parts of Boost your code is using; and to print reports on Boost usage (including Licence information).",
-        "url": "tools/bcp/",
+        "version_specific": True,
+        "url_path": "tools/bcp/",
     },
     {
         "name": "QuickBook",
-        "slug": "quickbook",
         "description": "QuickBook is a WikiWiki style documentation tool geared towards C++ documentation using simple rules and markup for simple formatting tasks. QuickBook generates BoostBook XML.",
-        "url": "",
+        "url_path": "https://www.boost.org/doc/libs/latest/doc/html/quickbook.html",
+        "version_specific": False,
     },
     {
         "name": "Wave",
         "slug": "wave",
         "description": "A Standards conformant C/C++ preprocessor usable on top of any other compiler. Usable for instance for the debugging of the expansion of macros in your code or as a replacement for your built-in preprocessor.",
-        "url": "",
+        "version_specific": True,
+        "url_path": "libs/wave/index.html",
     },
 ]

libraries/utils.py

@@ -373,19 +373,39 @@ def generate_release_report_filename(version_slug: str, published_format: bool =
     return filename
 
 
-def get_tools():
+def get_tools(version=None):
     """
     Return list of tool dictionaries.
 
     Tools are utilities used by Boost developers and users,
     separate from libraries. They appear alongside libraries
     in library list views.
 
+    Args:
+        version: Optional Version object. If provided, tools with
+            version_specific=True will have their URLs generated
+            based on the version.
+
     Returns:
         list: List of tool dictionaries with keys:
             - name: str
-            - slug: str
             - description: str
-            - url: str
+            - url: str (generated for version_specific tools if version provided)
     """
-    return sorted(TOOLS.copy(), key=lambda tool: tool["name"].lower())
+    tools = []
+    for tool in TOOLS.copy():
+        tool_dict = tool.copy()
+        url_path = tool_dict.get("url_path", "")
+        if tool_dict.get("version_specific"):
+            if version:
+                version_slug = version.stripped_boost_url_slug
+                tool_dict["url"] = (
+                    f"https://www.boost.org/doc/libs/{version_slug}/{url_path}"
+                )
+            else:
+                tool_dict["url"] = ""
+        else:
+            # For non-version-specific tools, use url_path as-is (full URL)
+            tool_dict["url"] = url_path
+        tools.append(tool_dict)
+    return sorted(tools, key=lambda tool: tool["name"].lower())

libraries/views.py

@@ -105,7 +105,7 @@ def get_queryset(self):
     def get_context_data(self, **kwargs):
         context = super().get_context_data(**self.kwargs)
         context["categories"] = self.get_categories(context["selected_version"])
-        context["tools"] = get_tools()
+        context["tools"] = get_tools(version=context.get("selected_version"))
         # todo: add tests for sort order
         if self.kwargs.get("category_slug"):
             context["category"] = Category.objects.get(
@@ -214,7 +214,7 @@ def get_results_by_category(self, version: Version | None):
             )
 
         # Add tools as a separate category
-        tools = get_tools()
+        tools = get_tools(version=version)
         if tools:
             # Create a simple object for tools category
             class ToolsCategory: