v0.9.0 client context support.

CMakeLists.txt

@@ -1,7 +1,7 @@
 cmake_minimum_required(VERSION 3.28)
 project(
   CppNet
-  VERSION 0.8.0
+  VERSION 0.9.0
   LANGUAGES CXX)
 
 # net requires at least C++20
@@ -13,14 +13,6 @@ include(FetchContent)
 # https://github.com/cpm-cmake/CPM.cmake#adding-cpm
 include(cmake/CPM.cmake)
 
-# Add stdexec as a dependency
-CPMAddPackage(
-  URI "gh:NVIDIA/stdexec#main"
-  OPTIONS
-    "STDEXEC_BUILD_EXAMPLES OFF"
-    "STDEXEC_BUILD_TESTING OFF"
-)
-
 # Add AsyncBerkeley as a dependency.
 CPMAddPackage(
   URI "gh:kcexn/async-berkeley@0.4.1"
@@ -34,7 +26,7 @@ add_library(cppnet INTERFACE)
 target_include_directories(
   cppnet INTERFACE $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/include/>
                    $<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>)
-target_link_libraries(cppnet INTERFACE asyncberk STDEXEC::stdexec)
+target_link_libraries(cppnet INTERFACE asyncberk)
 install(DIRECTORY ${PROJECT_SOURCE_DIR}/include/
         DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
 

include/net/cppnet.hpp

@@ -1,18 +1,16 @@
-/* Copyright (C) 2025 Kevin Exton (kevin.exton@pm.me)
- *
- * cppnet is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published
- * by the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * cppnet is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with cppnet.  If not, see <https://www.gnu.org/licenses/>.
- */
+// Copyright 2025 Kevin Exton
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
 /**
  * @file cppnet.hpp
  * @brief This file exports the public cppnet interface.

include/net/detail/concepts.hpp

@@ -1,18 +1,16 @@
-/* Copyright (C) 2025 Kevin Exton (kevin.exton@pm.me)
- *
- * cppnet is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published
- * by the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * cppnet is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with cppnet.  If not, see <https://www.gnu.org/licenses/>.
- */
+// Copyright 2025 Kevin Exton
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
 /**
  * @file concepts.hpp
  * @brief This file defines concepts for cppnet.
@@ -21,6 +19,7 @@
 #ifndef CPPNET_CONCEPT_HPP
 #define CPPNET_CONCEPT_HPP
 #include <concepts>
+#include <system_error>
 // Forward declarations
 namespace net::service {
 struct async_context;
@@ -38,12 +37,17 @@ concept BasicLockable = requires(Lock lock) {
   { lock.unlock() } -> std::same_as<void>;
 };
 
-/** @brief ServiceLike describes types that behave like an application or
- * service. */
+/**
+ * @brief Constrains types that behave like an application or service.
+ * @details ServiceLike functions can mutate state in the asynchronous
+ * context.
+ * @note A ServiceLike may call `ctx.scope.request_stop()` any time it
+ * runs.
+ */
 template <typename S>
 concept ServiceLike = requires(S service, service::async_context &ctx) {
   { service.signal_handler(1) } noexcept -> std::same_as<void>;
-  { service.start(ctx) } noexcept -> std::same_as<void>;
+  { service.start(ctx) } noexcept -> std::same_as<std::error_code>;
 };
 
 /** @brief This namespace is for timers and interrupts. */

include/net/detail/immovable.hpp

@@ -1,18 +1,16 @@
-/* Copyright (C) 2025 Kevin Exton (kevin.exton@pm.me)
- *
- * cppnet is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published
- * by the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * cppnet is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with cppnet.  If not, see <https://www.gnu.org/licenses/>.
- */
+// Copyright 2025 Kevin Exton
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
 /**
  * @file immovable.hpp
  * @brief This file defines immovable.

include/net/detail/with_lock.hpp

@@ -1,18 +1,16 @@
-/* Copyright (C) 2025 Kevin Exton (kevin.exton@pm.me)
- *
- * cppnet is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published
- * by the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * cppnet is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with cppnet.  If not, see <https://www.gnu.org/licenses/>.
- */
+// Copyright 2025 Kevin Exton
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
 /**
  * @file with_lock.hpp
  * @brief This file defines with_lock.

include/net/service/async_context.hpp

@@ -1,18 +1,16 @@
-/* Copyright (C) 2025 Kevin Exton (kevin.exton@pm.me)
- *
- * cppnet is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published
- * by the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * cppnet is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with cppnet.  If not, see <https://www.gnu.org/licenses/>.
- */
+// Copyright 2025 Kevin Exton
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
 
 /**
  * @file async_context.hpp

include/net/service/async_tcp_service.hpp

@@ -1,18 +1,16 @@
-/* Copyright (C) 2025 Kevin Exton (kevin.exton@pm.me)
- *
- * cppnet is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published
- * by the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * cppnet is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with cppnet.  If not, see <https://www.gnu.org/licenses/>.
- */
+// Copyright 2025 Kevin Exton
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
 /**
  * @file async_tcp_service.hpp
  * @brief This file declares an asynchronous tcp service.
@@ -112,8 +110,9 @@ class async_tcp_service {
   /**
    * @brief Start the service on the context.
    * @param ctx The async context to start the service on.
+   * @return An error code indicating success.
    */
-  auto start(async_context &ctx) noexcept -> void;
+  auto start(async_context &ctx) noexcept -> std::error_code;
   /**
    * @brief Submits an asynchronous socket recv.
    * @param ctx The async context to start the reader on.

include/net/service/async_udp_service.hpp

@@ -1,18 +1,16 @@
-/* Copyright (C) 2025 Kevin Exton (kevin.exton@pm.me)
- *
- * cppnet is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published
- * by the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * cppnet is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with cppnet.  If not, see <https://www.gnu.org/licenses/>.
- */
+// Copyright 2025 Kevin Exton
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
 /**
  * @file async_udp_service.hpp
  * @brief This file declares an asynchronous udp service.
@@ -115,8 +113,9 @@ class async_udp_service {
   /**
    * @brief Start the service on the context.
    * @param ctx The async context to start the service on.
+   * @returns an error code indicating success.
    */
-  auto start(async_context &ctx) noexcept -> void;
+  auto start(async_context &ctx) noexcept -> std::error_code;
   /**
    * @brief Submits an asynchronous socket recv.
    * @param ctx The async context to start the reader on.