refactor: migrate from Boost.Buffers to Boost.Capy.Buffers

- Remove Boost::buffers dependency from CMakeLists.txt and Jamfile
- Change all includes from boost/buffers/ to boost/capy/buffers/
- Replace buffers:: namespace with capy:: throughout codebase
- Rename buffers::size() to capy::buffer_size()
- Rename buffers::dynamic_for() to capy::make_any()
- Add dynamic_buffer_ref wrapper in impl/parser.hpp for reference semantics
- Update test files to use new capy buffer types and functions
- Add .temp/ to .gitignore for build outputs

Author: vinniefalco

.cursor/rules/build-outputs.mdc

@@ -0,0 +1,50 @@
+---
+description: Build outputs must go in .temp directory
+globs:
+alwaysApply: true
+---
+
+# Build Output Directory Policy
+
+**All build artifacts, intermediate files, and temporary outputs MUST go in the `.temp/` directory.**
+
+## Required Directory Structure
+
+- `.temp/build-msvc/` - MSVC/Visual Studio builds
+- `.temp/build-gcc/` - GCC builds (via MSYS2)
+- `.temp/build-clang/` - Clang builds
+- `.temp/build-ninja/` - Ninja builds
+- `.temp/` - Any other temporary or generated files
+
+## Rules
+
+1. **Never create executables, object files, or build artifacts in source directories**
+2. **Never commit anything from `.temp/`** - it is in `.gitignore`
+3. When configuring CMake, always use `-B .temp/build-<compiler>`
+4. When running direct compiler commands, output to `.temp/build-<compiler>/`
+
+## Example Commands
+
+### CMake (MSVC)
+```powershell
+cmake -B .temp/build-msvc -G "Visual Studio 18 2026" -A x64
+cmake --build .temp/build-msvc --config Release
+```
+
+### CMake (GCC via MSYS2)
+```bash
+cmake -B .temp/build-gcc -G "Unix Makefiles"
+cmake --build .temp/build-gcc
+```
+
+### Direct GCC compilation
+```bash
+mkdir -p .temp/build-gcc
+g++ -std=c++20 -O3 src/main.cpp -o .temp/build-gcc/main.exe
+```
+
+### Direct MSVC compilation
+```powershell
+New-Item -ItemType Directory -Force -Path .temp/build-msvc
+cl /std:c++20 /O2 src/main.cpp /Fe:.temp/build-msvc/main.exe
+```

.gitignore

@@ -20,3 +20,6 @@ temp
 /.cache
 /.clangd
 /compile_commands.json
+
+/.temp
+

CMakeLists.txt

@@ -55,7 +55,6 @@ set(BOOST_SRC_DIR ${DEFAULT_BOOST_SRC_DIR} CACHE STRING "Boost source dir to use
 # The boost super-project requires one explicit dependency per-line.
 set(BOOST_HTTP_DEPENDENCIES
     Boost::assert
-    Boost::buffers
     Boost::capy
     Boost::config
     Boost::core
@@ -122,7 +121,7 @@ if (BOOST_HTTP_IS_ROOT)
         set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${BOOST_SRC_DIR}/tools/cmake/include")
     else ()
         # From Boost Package
-        find_package(Boost REQUIRED COMPONENTS buffers filesystem json url)
+        find_package(Boost REQUIRED COMPONENTS filesystem json url)
         foreach (BOOST_INCLUDE_LIBRARY ${BOOST_INCLUDE_LIBRARIES})
             if (NOT TARGET Boost::${BOOST_INCLUDE_LIBRARY})
                 add_library(Boost::${BOOST_INCLUDE_LIBRARY} ALIAS Boost::headers)

build/Jamfile

@@ -39,14 +39,12 @@ explicit http_sources ;
 lib boost_http
    : http_sources
    : requirements
-     <library>/boost//buffers
      <library>/boost//capy
      <library>/boost/json//boost_json/<warnings-as-errors>off
      <library>/boost//url
      <include>../
      <define>BOOST_HTTP_SOURCE
    : usage-requirements
-     <library>/boost//buffers
      <library>/boost//capy
      <library>/boost/json//boost_json/<warnings-as-errors>off
      <library>/boost//url

include/boost/http/file_sink.hpp

@@ -68,7 +68,7 @@ class file_sink
     BOOST_HTTP_DECL
     results
     on_write(
-        buffers::const_buffer, bool) override;
+        capy::const_buffer, bool) override;
 };
 
 } // http

include/boost/http/file_source.hpp

@@ -78,7 +78,7 @@ class file_source
     BOOST_HTTP_DECL
     results
     on_read(
-        buffers::mutable_buffer b) override;
+        capy::mutable_buffer b) override;
 };
 
 } // http

include/boost/http/impl/parser.hpp

@@ -20,6 +20,69 @@
 
 namespace boost {
 namespace http {
+namespace detail {
+
+// A wrapper that provides reference semantics for dynamic buffers
+// while satisfying the dynamic_buffer concept
+template<class DynamicBuffer>
+class dynamic_buffer_ref
+{
+    DynamicBuffer* p_;
+
+public:
+    using const_buffers_type = typename DynamicBuffer::const_buffers_type;
+    using mutable_buffers_type = typename DynamicBuffer::mutable_buffers_type;
+
+    explicit
+    dynamic_buffer_ref(DynamicBuffer& b) noexcept
+        : p_(&b)
+    {
+    }
+
+    std::size_t
+    size() const noexcept
+    {
+        return p_->size();
+    }
+
+    std::size_t
+    max_size() const noexcept
+    {
+        return p_->max_size();
+    }
+
+    std::size_t
+    capacity() const noexcept
+    {
+        return p_->capacity();
+    }
+
+    const_buffers_type
+    data() const noexcept
+    {
+        return p_->data();
+    }
+
+    mutable_buffers_type
+    prepare(std::size_t n)
+    {
+        return p_->prepare(n);
+    }
+
+    void
+    commit(std::size_t n)
+    {
+        p_->commit(n);
+    }
+
+    void
+    consume(std::size_t n)
+    {
+        p_->consume(n);
+    }
+};
+
+} // detail
 
 template<class ElasticBuffer>
 typename std::enable_if<
@@ -39,7 +102,7 @@ set_body(
 
     // Check ElasticBuffer type requirements
     static_assert(
-        buffers::is_dynamic_buffer<ElasticBuffer>::value,
+        capy::is_dynamic_buffer<ElasticBuffer>::value,
         "Type requirements not met.");
 
     // body must not already be set
@@ -51,7 +114,7 @@ set_body(
         detail::throw_logic_error();
 
     auto& dyn = ws().emplace<
-        buffers::any_dynamic_buffer_impl<typename
+        capy::any_dynamic_buffer_impl<typename
             std::decay<ElasticBuffer>::type,
                 buffers_N>>(std::forward<ElasticBuffer>(eb));
 
@@ -66,7 +129,7 @@ set_body(
 {
     // Check ElasticBuffer type requirements
     static_assert(
-        buffers::is_dynamic_buffer<ElasticBuffer>::value,
+        capy::is_dynamic_buffer<ElasticBuffer>::value,
         "Type requirements not met.");
 
     // body must not already be set
@@ -77,10 +140,11 @@ set_body(
     if(! got_header())
         detail::throw_logic_error();
 
+    // Use dynamic_buffer_ref to provide reference semantics
     auto& dyn = ws().emplace<
-        buffers::any_dynamic_buffer_impl<typename
-            std::decay<ElasticBuffer>::type&,
-                buffers_N>>(eb);
+        capy::any_dynamic_buffer_impl<
+            detail::dynamic_buffer_ref<ElasticBuffer>,
+            buffers_N>>(eb.get());
 
     set_body_impl(dyn);
 }

include/boost/http/impl/serializer.hpp

@@ -28,7 +28,7 @@ class serializer::cbs_gen
     // Return the next non-empty buffer or an
     // empty buffer if none remain.
     virtual
-    buffers::const_buffer
+    capy::const_buffer
     next() = 0;
 
     // Return the total size and count of
@@ -48,27 +48,27 @@ template<class ConstBufferSequence>
 class serializer::cbs_gen_impl
     : public cbs_gen
 {
-    using it_t = decltype(buffers::begin(
+    using it_t = decltype(capy::begin(
         std::declval<ConstBufferSequence>()));
 
     ConstBufferSequence cbs_;
     it_t curr_;
 
 public:
     using const_buffer =
-        buffers::const_buffer;
+        capy::const_buffer;
 
     explicit
     cbs_gen_impl(ConstBufferSequence cbs)
         : cbs_(std::move(cbs))
-        , curr_(buffers::begin(cbs_))
+        , curr_(capy::begin(cbs_))
     {
     }
 
     const_buffer
     next() override
     {
-        while(curr_ != buffers::end(cbs_))
+        while(curr_ != capy::end(cbs_))
         {
             // triggers conversion operator
             const_buffer buf = *curr_++;
@@ -82,7 +82,7 @@ class serializer::cbs_gen_impl
     stats() const override
     {
         stats_t r;
-        for(auto it = curr_; it != buffers::end(cbs_); ++it)
+        for(auto it = curr_; it != capy::end(cbs_); ++it)
         {
             // triggers conversion operator
             const_buffer buf = *it;
@@ -98,7 +98,7 @@ class serializer::cbs_gen_impl
     bool
     is_empty() const override
     {
-        for(auto it = curr_; it != buffers::end(cbs_); ++it)
+        for(auto it = curr_; it != capy::end(cbs_); ++it)
         {
             // triggers conversion operator
             const_buffer buf = *it;
@@ -120,8 +120,8 @@ start(
     message_base const& m,
     ConstBufferSequence&& cbs)
 {
-    static_assert(buffers::is_const_buffer_sequence<
-            ConstBufferSequence>::value,
+    static_assert(
+        capy::const_buffer_sequence<ConstBufferSequence>,
         "ConstBufferSequence type requirements not met");
 
     start_init(m);

include/boost/http/impl/sink.hpp

@@ -10,8 +10,8 @@
 #ifndef BOOST_HTTP_IMPL_SINK_HPP
 #define BOOST_HTTP_IMPL_SINK_HPP
 
-#include <boost/buffers/buffer.hpp>
-#include <boost/buffers/range.hpp>
+#include <boost/capy/buffers.hpp>
+#include <boost/capy/buffers/range.hpp>
 #include <boost/http/detail/except.hpp>
 #include <boost/assert.hpp>
 
@@ -44,10 +44,10 @@ write_impl(
 {
     results rv;
     constexpr int SmallArraySize = 16;
-    buffers::const_buffer tmp[SmallArraySize];
+    capy::const_buffer tmp[SmallArraySize];
     auto const tmp_end = tmp + SmallArraySize;
-    auto it = buffers::begin(bs);
-    auto const end_ = buffers::end(bs);
+    auto it = capy::begin(bs);
+    auto const end_ = capy::end(bs);
     while(it != end_)
     {
         auto p = tmp;
@@ -59,7 +59,7 @@ write_impl(
             p != tmp_end &&
             it != end_);
         rv += on_write(boost::span<
-            buffers::const_buffer const>(
+            capy::const_buffer const>(
                 tmp, p - tmp),
             it != end_ || more);
         if(rv.ec.failed())

include/boost/http/impl/source.hpp

@@ -43,11 +43,11 @@ read_impl(
 {
     results rv;
     constexpr int SmallArraySize = 16;
-    buffers::mutable_buffer tmp[SmallArraySize];
+    capy::mutable_buffer tmp[SmallArraySize];
     auto const tmp_end =
         tmp + SmallArraySize;
-    auto it = buffers::begin(bs);
-    auto const end_ = buffers::end(bs);
+    auto it = capy::begin(bs);
+    auto const end_ = capy::end(bs);
     while(it != end_)
     {
         auto p = tmp;
@@ -59,7 +59,7 @@ read_impl(
             p != tmp_end &&
             it != end_);
         rv += on_read(boost::span<
-            buffers::mutable_buffer const>(
+            capy::mutable_buffer const>(
                 tmp, p - tmp));
         if(rv.ec.failed())
             return rv;