feat: grammar::range user-provided RangeRule

.github/workflows/ci.yml

@@ -53,7 +53,7 @@ jobs:
       matrix: ${{ steps.cpp-matrix.outputs.matrix }}
     steps:
       - name: Generate Test Matrix
-        uses: alandefreitas/cpp-actions/cpp-matrix@v1.8.10
+        uses: alandefreitas/cpp-actions/cpp-matrix@v1.9.0
         id: cpp-matrix
         with:
           compilers: |
@@ -111,21 +111,21 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Setup C++
-        uses: alandefreitas/cpp-actions/setup-cpp@v1.8.10
+        uses: alandefreitas/cpp-actions/setup-cpp@v1.9.0
         id: setup-cpp
         with:
           compiler: ${{ matrix.compiler }}
           version: ${{ matrix.version }}
 
       - name: Install packages
         if: matrix.install != ''
-        uses: alandefreitas/cpp-actions/package-install@v1.8.10
+        uses: alandefreitas/cpp-actions/package-install@v1.9.0
         id: package-install
         with:
           apt-get: ${{ matrix.install }}
 
       - name: Clone Boost
-        uses: alandefreitas/cpp-actions/boost-clone@v1.8.10
+        uses: alandefreitas/cpp-actions/boost-clone@v1.9.0
         id: boost-clone
         with:
           branch: ${{ (github.ref_name == 'master' && github.ref_name) || 'develop' }}
@@ -203,7 +203,7 @@ jobs:
             corpus-
 
       - name: CMake Workflow
-        uses: alandefreitas/cpp-actions/cmake-workflow@v1.8.10
+        uses: alandefreitas/cpp-actions/cmake-workflow@v1.9.0
         if: matrix.is-no-factor-intermediary != 'true'
         with:
           source-dir: ../boost-root
@@ -226,7 +226,7 @@ jobs:
           trace-commands: true
 
       - name: CMake Integration Workflow
-        uses: alandefreitas/cpp-actions/cmake-workflow@v1.8.10
+        uses: alandefreitas/cpp-actions/cmake-workflow@v1.9.0
         if: matrix.is-no-factor-intermediary != 'true'
         with:
           source-dir: ../boost-root/libs/${{ steps.patch.outputs.module }}/test/cmake_test
@@ -244,7 +244,7 @@ jobs:
           trace-commands: true
 
       - name: CMake Root Workflow
-        uses: alandefreitas/cpp-actions/cmake-workflow@v1.8.10
+        uses: alandefreitas/cpp-actions/cmake-workflow@v1.9.0
         if: matrix.is-no-factor-intermediary != 'true'
         with:
           source-dir: .
@@ -263,7 +263,7 @@ jobs:
           trace-commands: true
 
       - name: B2 Workflow
-        uses: alandefreitas/cpp-actions/b2-workflow@v1.8.10
+        uses: alandefreitas/cpp-actions/b2-workflow@v1.9.0
         env:
           # Set flags via B2 options exclusively
           CFLAGS: ''
@@ -291,7 +291,7 @@ jobs:
           warnings-as-errors: true
 
       - name: FlameGraph
-        uses: alandefreitas/cpp-actions/flamegraph@v1.8.10
+        uses: alandefreitas/cpp-actions/flamegraph@v1.9.0
         if: matrix.time-trace
         with:
           source-dir: ../boost-root/libs/url
@@ -362,7 +362,7 @@ jobs:
           fetch-depth: 100
 
       - name: Changelog
-        uses: alandefreitas/cpp-actions/create-changelog@v1.8.10
+        uses: alandefreitas/cpp-actions/create-changelog@v1.9.0
         with:
           thank-non-regular: ${{ startsWith(github.ref, 'refs/tags/') }}
           github-token: ${{ secrets.GITHUB_TOKEN }}
@@ -385,15 +385,15 @@ jobs:
         shell: bash
     steps:
       - name: Install packages
-        uses: alandefreitas/cpp-actions/package-install@v1.8.10
+        uses: alandefreitas/cpp-actions/package-install@v1.9.0
         with:
           apt-get: git cmake
 
       - name: Clone Boost.URL
         uses: actions/checkout@v4
 
       - name: Clone Boost
-        uses: alandefreitas/cpp-actions/boost-clone@v1.8.10
+        uses: alandefreitas/cpp-actions/boost-clone@v1.9.0
         id: boost-clone
         with:
           branch: ${{ (github.ref_name == 'master' && github.ref_name) || 'develop' }}

doc/mrdocs.yml

@@ -41,6 +41,8 @@ implementation-defined:
   - 'boost::urls::string_token::*_t'
 exclude-symbols:
   - 'boost::urls::void_t'
+  # any_rule was previously excluded by the detail path rule
+  - 'boost::urls::any_rule'
 
 # Metadata Extraction
 private-bases: false

include/boost/url/grammar/detail/range_rule.hpp

@@ -0,0 +1,95 @@
+//
+// Copyright (c) 2025 Alan de Freitas (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/url
+//
+
+#ifndef BOOST_URL_GRAMMAR_DETAIL_RANGE_RULE_HPP
+#define BOOST_URL_GRAMMAR_DETAIL_RANGE_RULE_HPP
+
+#include <boost/url/detail/config.hpp>
+#include <type_traits>
+#include <utility>
+
+namespace boost {
+namespace urls {
+namespace grammar {
+namespace detail {
+
+template<class RangeRule, bool = std::is_empty<RangeRule>::value>
+class range_base_storage;
+
+template<class RangeRule>
+class range_base_storage<RangeRule, false>
+{
+    RangeRule rule_;
+
+protected:
+    range_base_storage() = default;
+
+    explicit
+    range_base_storage(RangeRule const& rule)
+        : rule_(rule)
+    {
+    }
+
+    explicit
+    range_base_storage(RangeRule&& rule)
+        : rule_(std::move(rule))
+    {
+    }
+
+    RangeRule&
+    rule() noexcept
+    {
+        return rule_;
+    }
+
+    RangeRule const&
+    rule() const noexcept
+    {
+        return rule_;
+    }
+};
+
+template<class RangeRule>
+class range_base_storage<RangeRule, true>
+    : private RangeRule
+{
+protected:
+    range_base_storage() = default;
+
+    explicit
+    range_base_storage(RangeRule const& rule)
+        : RangeRule(rule)
+    {
+    }
+
+    explicit
+    range_base_storage(RangeRule&& rule)
+        : RangeRule(std::move(rule))
+    {
+    }
+
+    RangeRule&
+    rule() noexcept
+    {
+        return *this;
+    }
+
+    RangeRule const&
+    rule() const noexcept
+    {
+        return *this;
+    }
+};
+
+} // detail
+} // grammar
+} // urls
+} // boost
+
+#endif