netlib v2 greenfield

CHANGELOG.md

@@ -4,6 +4,31 @@
 
 ## [Unreleased]
 
+### Changed
+
+- Завершена module-first миграция netlib 2.0: реализация v2 перенесена в
+  `modules/cxx/**/*.cppm`, заголовочные пути v2 оставлены compatibility import
+  facades без собственной реализации.
+- C++26 modules теперь обязательны; минимальные требования — CMake 3.30,
+  Ninja, Clang 18+, GCC 15+ или MSVC 19.38+.
+- Канонический target потребителя — `netlib::modules`, основной импорт —
+  `import netlib;`.
+- Legacy v1 API и документация сохранены, но больше не являются рекомендуемой
+  точкой входа.
+
+### Added
+
+- Иерархия модулей `netlib.core`, `netlib.io`, `netlib.io.coro` и платформенные
+  primary modules `netlib.platform.uring`, `netlib.platform.rio`,
+  `netlib.platform.poll`.
+- Core-типы без stdlib, pipe/coroutine API, TCP/UDP, stop/cancel, mock engine и
+  платформенные backends для io_uring, RIO и poll.
+- Установка экспортирует `netlib::modules` вместе с CMake `CXX_MODULES`
+  `FILE_SET`; добавлен внешний install-consumer smoke.
+- Локальный `scripts/ci.sh`: Clang по умолчанию, GCC 15+ по запросу; build,
+  nostd module gate, runtime smoke, `ctest`, install и external consumer.
+- V2 echo/UDP examples и loopback benchmarks для поддерживаемых платформ.
+
 ## [1.0.0] — 2026-05-22
 
 Первый стабильный релиз поверх bootstrap `0.1.0`. Semver: `find_package(netlib 1.0)`.
@@ -24,4 +49,5 @@
 
 ## [0.1.0] — bootstrap
 
-- Header-only `netlib::netlib`, execution fallback, TCP epoll, Catch2 tests
+- Legacy v1 bootstrap: header-only `netlib::netlib`, execution fallback, TCP
+  epoll, Catch2 tests

CMakeLists.txt

@@ -1,10 +1,10 @@
-cmake_minimum_required(VERSION 3.24)
+cmake_minimum_required(VERSION 3.30)
 
-project(netlib VERSION 1.0.0 LANGUAGES CXX)
+project(netlib VERSION 2.0.0 LANGUAGES CXX)
 
 include(${CMAKE_CURRENT_LIST_DIR}/cmake/netlib_options.cmake)
 include(${CMAKE_CURRENT_LIST_DIR}/cmake/netlib_probes.cmake)
-include(${CMAKE_CURRENT_LIST_DIR}/cmake/netlib_target.cmake)
+include(${CMAKE_CURRENT_LIST_DIR}/cmake/netlib_core.cmake)
 include(${CMAKE_CURRENT_LIST_DIR}/cmake/netlib_install.cmake)
 
 if(NETLIB_BUILD_EXAMPLES)

README.md

@@ -1,72 +1,88 @@
 # netlib
 
-**v1.0.0** — header-only C++23 библиотека: слой **execution** (планирование задач) и **net** (TCP, UDP, UNIX stream, reactor).
+**netlib 2.0** — module-first библиотека сетевого I/O на C++26. Каноническая
+реализация находится только в `modules/cxx/**/*.cppm`; основной вход для
+потребителя — `import netlib;` и CMake-target `netlib::modules`.
 
-- Namespace: `rrmode::netlib::{execution,net}`
-- Зависимости: только стандартная библиотека + платформенный код в `::detail`
-- Платформы: Linux (epoll), macOS (kqueue), Windows (WSAPoll + unit-тесты)
+- Namespace: `rrmode::netlib`
+- Core: собственные `span`, `result`, контейнеры и `-nostdinc++` compile gate
+- I/O: Linux `io_uring`, Windows RIO, macOS/POSIX `poll`
+- Tests/examples могут использовать C++ standard library и Catch2
 
-## Быстрый старт
+## Требования v2
 
-```bash
-cmake -B build -DCMAKE_BUILD_TYPE=Debug -DNETLIB_BUILD_TESTS=ON -DNETLIB_BUILD_EXAMPLES=ON
-cmake --build build -j
-ctest --test-dir build
-```
+| Компонент | Минимум |
+|-----------|---------|
+| CMake | 3.30 |
+| Generator | Ninja |
+| Язык | C++26 modules |
+| Toolchain | Clang 18+, GCC 15+ или MSVC 19.38+ |
+
+`NETLIB_BUILD_MODULES=ON` включён по умолчанию и обязателен для v2.
+`NETLIB_MODULES_CXX_STANDARD` зафиксирован в `26`.
 
-Терминал 1:
+## Быстрый старт
 
 ```bash
-./build/examples/tcp_echo/tcp_echo_server 9001
+cmake -S . -B build-cxx26 -G Ninja \
+  -DCMAKE_CXX_COMPILER=clang++ \
+  -DCMAKE_BUILD_TYPE=Debug \
+  -DNETLIB_BUILD_MODULES=ON \
+  -DNETLIB_MODULES_CXX_STANDARD=26 \
+  -DNETLIB_BUILD_TESTS=ON \
+  -DNETLIB_BUILD_EXAMPLES=ON
+cmake --build build-cxx26 -j
+ctest --test-dir build-cxx26 --output-on-failure
 ```
 
-Терминал 2:
+Локальный полный pipeline:
 
 ```bash
-./build/examples/tcp_echo/tcp_echo_client 9001 hello
-# ответ: hello
+./scripts/ci.sh        # Clang 18+ по умолчанию
+./scripts/ci.sh gcc    # требуется GCC 15+
 ```
 
-## Документация
-
-Полный набор — **[docs/README.md](docs/README.md)** (Markdown + PlantUML, без Doxygen).
+Он выполняет сборку, module smoke и `-nostdinc++` gate, runtime smoke,
+`ctest`, установку и сборку внешнего потребителя установленного модуля.
 
-| Раздел | Файлы |
-|--------|--------|
-| Старт | [GETTING_STARTED](docs/GETTING_STARTED.md), [INSTALL](docs/INSTALL.md), [API_LAYERS](docs/API_LAYERS.md) |
-| Архитектура | [ARCHITECTURE](docs/ARCHITECTURE.md), [EXECUTION](docs/EXECUTION.md), [NET_REACTOR](docs/NET_REACTOR.md) |
-| Протоколы | [NET_TCP](docs/NET_TCP.md), [NET_UDP](docs/NET_UDP.md), [NET_UNIX](docs/NET_UNIX.md) |
-| Coroutines | [COROUTINES](docs/COROUTINES.md), [CANCELLATION_AND_TIMEOUT](docs/CANCELLATION_AND_TIMEOUT.md), [LIFECYCLE](docs/LIFECYCLE.md) |
-| Справочник | [HEADERS_REFERENCE](docs/HEADERS_REFERENCE.md) |
-| Сборка / платформы | [CMAKE_OPTIONS](docs/CMAKE_OPTIONS.md), [PLATFORMS](docs/PLATFORMS.md) |
-| Ошибки | [ERRORS](docs/ERRORS.md) |
-| Примеры | [EXAMPLES](docs/EXAMPLES.md) |
-| Разработка / релиз | [DEVELOPMENT](docs/DEVELOPMENT.md), [V1_RELEASE](docs/V1_RELEASE.md), [CHANGELOG](../CHANGELOG.md) |
-| Эксплуатация | [TESTING](docs/TESTING.md), [BENCHMARKS](docs/BENCHMARKS.md), [ROADMAP](docs/ROADMAP.md) |
-| Диаграммы | [docs/diagrams/](docs/diagrams/) |
-
-## Подключение в CMake
+## Подключение
 
 ```cmake
-add_subdirectory(path/to/netlib)  # или find_package(netlib)
-target_link_libraries(app PRIVATE netlib::netlib)
-```
+find_package(netlib 2 CONFIG REQUIRED)
 
-Три уровня API (см. [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)):
+add_executable(app main.cpp)
+target_link_libraries(app PRIVATE netlib::modules)
+target_compile_features(app PRIVATE cxx_std_26)
+set_target_properties(app PROPERTIES CXX_SCAN_FOR_MODULES ON)
+```
 
 ```cpp
-#include <netlib/simple.hpp>   // простой sync + write_stream
-#include <netlib/medium.hpp>   // socket_options, io_context
-#include <netlib/netlib.hpp>   // full: event_loop, колбэки
+import netlib;
+
+int main() {
+    rrmode::netlib::inplace_vector<int, 4> values;
+    return values.push_back(26) ? 0 : 1;
+}
 ```
 
-Coroutines (если включены при сборке):
+Заголовки в `modules/netlib/**`, а также `include/netlib/netlib.hpp` и
+`include/netlib/io/coro.hpp`, оставлены только как compatibility import
+facades. Реализации v2 в них нет; для нового кода используйте прямой `import`.
 
-```cpp
-#include <netlib/execution/coroutine.hpp>
-#include <netlib/net/coro.hpp>
-// co_await connect_async(sock, loop, ep);
-```
+Подробнее:
+
+- [C++26 modules: иерархия, сборка и ограничения](docs/MODULES.md)
+- [Быстрый старт](docs/GETTING_STARTED.md)
+- [Установка и `find_package`](docs/INSTALL.md)
+- [Архитектура](docs/ARCHITECTURE.md)
+- [Полное оглавление](docs/README.md)
+- [Changelog](CHANGELOG.md)
+
+## Legacy v1
+
+API `execution`/`net`, `simple.hpp`/`medium.hpp`, callback reactor и target
+`netlib::netlib` относятся к legacy v1. Они сохранены для совместимости, но не
+являются рекомендуемой точкой входа v2. Их документы явно помечены `Legacy v1`.
 
 ## Лицензия
 

benchmarks/CMakeLists.txt

@@ -6,26 +6,62 @@ if(NETLIB_BENCHMARK_BUILD_SCHEDULE)
     target_include_directories(schedule_bench PRIVATE ${CMAKE_CURRENT_SOURCE_DIR})
 endif()
 
-if(NOT NETLIB_BENCHMARK_BUILD_NETWORK)
-    return()
-endif()
-
-if(WIN32 AND NETLIB_BENCHMARKS_REQUIRE_POSIX)
-    message(STATUS "netlib: tcp/udp benchmarks пропущены (NETLIB_BENCHMARKS_REQUIRE_POSIX)")
-    return()
-endif()
+if(NETLIB_BENCHMARK_BUILD_NETWORK)
+    if(WIN32 AND NETLIB_BENCHMARKS_REQUIRE_POSIX)
+        message(STATUS "netlib: tcp/udp benchmarks пропущены (NETLIB_BENCHMARKS_REQUIRE_POSIX)")
+    elseif(NETLIB_BENCHMARKS_REQUIRE_COROUTINES AND NOT NETLIB_ENABLE_COROUTINES)
+        message(STATUS "netlib: tcp/udp benchmarks требуют NETLIB_ENABLE_COROUTINES")
+    else()
+        find_package(Threads REQUIRED)
 
-if(NETLIB_BENCHMARKS_REQUIRE_COROUTINES AND NOT NETLIB_ENABLE_COROUTINES)
-    message(STATUS "netlib: tcp/udp benchmarks требуют NETLIB_ENABLE_COROUTINES")
-    return()
+        add_executable(tcp_echo_bench tcp_echo_bench.cpp)
+        add_executable(udp_ping_bench udp_ping_bench.cpp)
+        foreach(target tcp_echo_bench udp_ping_bench)
+            target_link_libraries(${target} PRIVATE netlib::netlib Threads::Threads)
+            target_compile_features(${target} PRIVATE cxx_std_${NETLIB_CXX_STANDARD})
+            target_include_directories(${target} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR})
+        endforeach()
+    endif()
 endif()
 
-find_package(Threads REQUIRED)
+if(NETLIB_BENCHMARK_BUILD_V2 AND NETLIB_ENABLE_COROUTINES)
+    set(_netlib_v2_bench_backend OFF)
+    if(CMAKE_SYSTEM_NAME STREQUAL "Linux" AND TARGET netlib::platform_uring)
+        set(_netlib_v2_bench_backend ON)
+    elseif(WIN32 AND TARGET netlib::platform_rio)
+        set(_netlib_v2_bench_backend ON)
+    elseif(CMAKE_SYSTEM_NAME STREQUAL "Darwin" AND TARGET netlib::platform_posix)
+        set(_netlib_v2_bench_backend ON)
+    endif()
 
-add_executable(tcp_echo_bench tcp_echo_bench.cpp)
-add_executable(udp_ping_bench udp_ping_bench.cpp)
-foreach(target tcp_echo_bench udp_ping_bench)
-    target_link_libraries(${target} PRIVATE netlib::netlib Threads::Threads)
-    target_compile_features(${target} PRIVATE cxx_std_${NETLIB_CXX_STANDARD})
-    target_include_directories(${target} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR})
-endforeach()
+    if(_netlib_v2_bench_backend)
+        find_package(Threads REQUIRED)
+        add_executable(v2_echo_bench v2_echo_bench.cpp)
+        add_executable(v2_udp_bench v2_udp_bench.cpp)
+        foreach(target v2_echo_bench v2_udp_bench)
+            target_link_libraries(${target} PRIVATE netlib::core Threads::Threads)
+            target_compile_features(${target} PRIVATE cxx_std_${NETLIB_CXX_STANDARD})
+            target_include_directories(${target} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR})
+        endforeach()
+        if(TARGET netlib::platform_uring)
+            foreach(target v2_echo_bench v2_udp_bench)
+                target_link_libraries(${target} PRIVATE netlib::platform_uring)
+                target_compile_definitions(${target} PRIVATE NETLIB_PLATFORM_LINUX=1 NETLIB_ENABLE_COROUTINES=1)
+            endforeach()
+        endif()
+        if(TARGET netlib::platform_rio)
+            foreach(target v2_echo_bench v2_udp_bench)
+                target_link_libraries(${target} PRIVATE netlib::platform_rio)
+                target_compile_definitions(${target} PRIVATE NETLIB_PLATFORM_WINDOWS=1 NETLIB_ENABLE_COROUTINES=1)
+            endforeach()
+        endif()
+        if(TARGET netlib::platform_posix)
+            foreach(target v2_echo_bench v2_udp_bench)
+                target_link_libraries(${target} PRIVATE netlib::platform_posix)
+                target_compile_definitions(${target} PRIVATE NETLIB_PLATFORM_POSIX=1 NETLIB_ENABLE_COROUTINES=1)
+            endforeach()
+        endif()
+    else()
+        message(STATUS "netlib: v2_echo_bench пропущен (нужен Linux io_uring, Windows RIO или macOS poll_engine)")
+    endif()
+endif()