chore: relocate sources and add build presets

- move implementation sources under src/corosio/src and adjust build files
- add CMakePresets.json default Ninja configure to out/build
- note portable capy::cond comparisons in docs and public API comments
- refresh ignore rules to keep build scripts while ignoring outputs

Author: vinniefalco

.gitignore

@@ -1,5 +1,6 @@
-/build-*/
-/bin64/
-.cache/
-/output/
-/.temp
+/.vscode/
+/build/
+!/build/Jamfile
+!/build/wolfssl.jam
+/out/
+CMakeUserPresets.json

CMakeLists.txt

@@ -130,20 +130,19 @@ file(GLOB_RECURSE BOOST_COROSIO_HEADERS CONFIGURE_DEPENDS
     "${CMAKE_CURRENT_SOURCE_DIR}/include/boost/corosio/*.hpp"
     "${CMAKE_CURRENT_SOURCE_DIR}/include/boost/corosio.hpp")
 file(GLOB_RECURSE BOOST_COROSIO_SOURCES CONFIGURE_DEPENDS
-    "${CMAKE_CURRENT_SOURCE_DIR}/src/*.hpp"
-    "${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp")
-# Exclude wolfssl files from main library (they are added separately when WolfSSL is found)
-list(FILTER BOOST_COROSIO_HEADERS EXCLUDE REGEX ".*/wolfssl/.*")
-list(FILTER BOOST_COROSIO_SOURCES EXCLUDE REGEX ".*/wolfssl/.*")
+    "${CMAKE_CURRENT_SOURCE_DIR}/src/corosio/src/*.hpp"
+    "${CMAKE_CURRENT_SOURCE_DIR}/src/corosio/src/*.cpp")
 
 source_group("" FILES "include/boost/corosio.hpp")
 source_group(TREE "${CMAKE_CURRENT_SOURCE_DIR}/include/boost/corosio" PREFIX "include" FILES ${BOOST_COROSIO_HEADERS})
-source_group(TREE "${CMAKE_CURRENT_SOURCE_DIR}/src" PREFIX "src" FILES ${BOOST_COROSIO_SOURCES})
+source_group(TREE "${CMAKE_CURRENT_SOURCE_DIR}/src/corosio/src" PREFIX "src" FILES ${BOOST_COROSIO_SOURCES})
 
 function(boost_corosio_setup_properties target)
     target_compile_features(${target} PUBLIC cxx_std_20)
     target_include_directories(${target} PUBLIC "${PROJECT_SOURCE_DIR}/include")
-    target_include_directories(${target} PRIVATE "${PROJECT_SOURCE_DIR}/src")
+    target_include_directories(${target} PRIVATE
+        "${PROJECT_SOURCE_DIR}/src/corosio"
+        "${PROJECT_SOURCE_DIR}/src/corosio/src")
     target_link_libraries(${target}
         PUBLIC
             ${BOOST_COROSIO_DEPENDENCIES}

CMakePresets.json

@@ -0,0 +1,16 @@
+{
+    "version": 8,
+    "configurePresets": [
+        {
+            "name": "Custom configure preset",
+            "displayName": "Custom configure preset",
+            "description": "Sets Ninja generator, build and install directory",
+            "generator": "Ninja",
+            "binaryDir": "${sourceDir}/out/build/${presetName}",
+            "cacheVariables": {
+                "CMAKE_BUILD_TYPE": "Debug",
+                "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}"
+            }
+        }
+    ]
+}

build/Jamfile

@@ -31,16 +31,11 @@ project boost/corosio
   : source-location $(COROSIO_ROOT)
   ;
 
-local COROSIO_SRC =
-    [ glob $(COROSIO_ROOT)/src/*.cpp ]
-    [ glob $(COROSIO_ROOT)/src/detail/*.cpp ]
-    ;
-
-alias corosio_sources : $(COROSIO_SRC) ;
-
 # System libraries
 lib ws2_32 ;
 
+alias corosio_sources : [ glob-tree-ex $(COROSIO_ROOT)/src/corosio/src : *.cpp ] ;
+
 lib boost_corosio
   : corosio_sources
   : requirements
@@ -50,7 +45,8 @@ lib boost_corosio
     <target-os>windows:<library>ws2_32
     <target-os>windows:<define>_WIN32_WINNT=0x0602
     <include>$(COROSIO_ROOT)/include
-    <include>$(COROSIO_ROOT)/src
+    <include>$(COROSIO_ROOT)/src/corosio
+    <include>$(COROSIO_ROOT)/src/corosio/src
   : usage-requirements
     <library>/boost/capy//boost_capy
     <library>/boost/url//boost_url

doc/modules/ROOT/pages/io/acceptor.adoc

@@ -115,7 +115,7 @@ capy::task<void> accept_loop(corosio::io_context& ioc)
 
         if (ec)
         {
-            if (ec == boost::system::errc::operation_canceled)
+            if (ec == capy::cond::canceled)
                 break;  // Acceptor was closed
             std::cerr << "Accept error: " << ec.message() << "\n";
             continue;

doc/modules/ROOT/pages/io/sockets.adoc

@@ -94,7 +94,7 @@ auto [ec, n] = co_await s.read_some(
 
 if (ec)
 {
-    if (ec == capy::error::eof)
+    if (ec == capy::cond::eof)
         std::cout << "Peer closed connection\n";
     else
         std::cerr << "Read error: " << ec.message() << "\n";
@@ -213,11 +213,11 @@ auto [ec, n] = co_await s.read_some(buf);
 
 if (ec)
 {
-    if (ec == capy::error::eof)
+    if (ec == capy::cond::eof)
     {
         // Normal disconnect (end of stream)
     }
-    else if (ec == boost::system::errc::operation_canceled)
+    else if (ec == capy::cond::canceled)
     {
         // We called cancel()
     }

include/boost/corosio/acceptor.hpp

@@ -235,7 +235,8 @@ class BOOST_COROSIO_DECL acceptor : public io_object
         @return An awaitable that completes with `io_result<>`.
             Returns success on successful accept, or an error code on
             failure including:
-            - operation_canceled: Cancelled via stop_token or cancel()
+            - operation_canceled: Cancelled via stop_token or cancel().
+                Check `ec == cond::canceled` for portable comparison.
 
         @par Preconditions
         The acceptor must be listening (`is_open() == true`).
@@ -259,6 +260,7 @@ class BOOST_COROSIO_DECL acceptor : public io_object
     /** Cancel any pending asynchronous operations.
 
         All outstanding operations complete with `errc::operation_canceled`.
+        Check `ec == cond::canceled` for portable comparison.
     */
     void cancel();
 

include/boost/corosio/io_stream.hpp

@@ -43,8 +43,10 @@ class BOOST_COROSIO_DECL io_stream : public io_object
         @return An awaitable that completes with a pair of
             `{error_code, bytes_transferred}`. Returns success with the
             number of bytes read, or an error code on failure including:
-            - capy::error::eof: End of stream reached
-            - operation_canceled: Cancelled via stop_token or cancel()
+            - capy::error::eof: End of stream reached.
+                Check `ec == cond::eof` for portable comparison.
+            - operation_canceled: Cancelled via stop_token or cancel().
+                Check `ec == cond::canceled` for portable comparison.
 
         @par Preconditions
         The socket must be open and connected.
@@ -75,7 +77,8 @@ class BOOST_COROSIO_DECL io_stream : public io_object
             `{error_code, bytes_transferred}`. Returns success with the
             number of bytes written, or an error code on failure including:
             - broken_pipe: Connection closed by peer
-            - operation_canceled: Cancelled via stop_token or cancel()
+            - operation_canceled: Cancelled via stop_token or cancel().
+                Check `ec == cond::canceled` for portable comparison.
 
         @par Preconditions
         The socket must be open and connected.

include/boost/corosio/resolver.hpp

@@ -310,6 +310,7 @@ class BOOST_COROSIO_DECL resolver : public io_object
     /** Cancel any pending asynchronous operations.
 
         All outstanding operations complete with `errc::operation_canceled`.
+        Check `ec == cond::canceled` for portable comparison.
     */
     void cancel();
 

include/boost/corosio/socket.hpp

@@ -241,7 +241,8 @@ class BOOST_COROSIO_DECL socket : public io_stream
             - connection_refused: No server listening at endpoint
             - timed_out: Connection attempt timed out
             - network_unreachable: No route to host
-            - operation_canceled: Cancelled via stop_token or cancel()
+            - operation_canceled: Cancelled via stop_token or cancel().
+                Check `ec == cond::canceled` for portable comparison.
 
         @par Preconditions
         The socket must be open (`is_open() == true`).
@@ -265,6 +266,7 @@ class BOOST_COROSIO_DECL socket : public io_stream
     /** Cancel any pending asynchronous operations.
 
         All outstanding operations complete with `errc::operation_canceled`.
+        Check `ec == cond::canceled` for portable comparison.
     */
     void cancel();