От первой программы до полной инженерной настройки.

#define XRT_IMPLEMENTATION
#include "xrt.h"
#include <stdio.h>

int main(void)
{
    printf("XRT %s\n", XRT_VERSION_TEXT);
    return 0;
}

cc -std=c11 -O2 main.c -o hello
./hello

gcc -std=c11 -O2 main.c -o hello.exe
.\hello.exe

Система сборки и проверенные примеры

Сетевые примеры живут в examples/ и в examples/ расширений и сопровождаются своими тестовыми наборами для изучения вызовов и жизненных циклов. Единая точка входа сборки tools/build.py даёт: инкрементальную компиляцию по SHA256-отпечаткам, развёртывание замыкания зависимостей модулей и автоматическое переключение response-файлов для длинных командных строк Windows; семейства компиляторов GCC / Clang / MSVC (включая clang-cl) / TCC взаимозаменяемы. build.bat и build.sh — тонкие обёртки над ней.

git clone https://gitee.com/xywhsoft/xrt.git
cd xrt

# По умолчанию: собрать и прогнать тесты ядра (build.bat на Windows, ./build.sh на Linux/macOS)
python tools/build.py

# Выбрать набор: имя модуля, комбинации через запятую или all; --jobs параллелит, --start-test возобновляет с падения
python tools/build.py --suite core,concurrency --jobs 4
python tools/build.py --suite all --start-test test_http_client

# Библиотеки расширения: подключить манифест расширения
python tools/build.py --manifest extlibs/xhttp/config/modules.json --suite xhttp_tests
python tools/build.py --manifest extlibs/xws/config/modules.json --suite xws_tests

# Упаковать статическую / динамическую библиотеку и собрать+запустить программы-потребители для проверки
python tools/package.py --kind static --verify
python tools/package.py --manifest extlibs/xhttp/config/modules.json --kind shared --verify

# Перегенерировать артефакт одного заголовка (поддерживает --manifest и проверку дрейфа --check)
python tools/amalgamate.py

Выберите форму поставки

Один заголовок (быстрая интеграция)

/* single/xrt.h содержит полную реализацию; расширения аналогично (напр. extlibs/xhttp/single/xhttp.h) */
#define XRT_IMPLEMENTATION
#include "xrt.h"

Модули / библиотека (инженерная интеграция)

Используйте tools/package.py для получения статической или динамической библиотеки (с import-библиотеками) или включите исходники ядра прямо в свою сборку — манифесты модулей уже объявляют владение и зависимости каждого файла исходников. Пути заголовков единообразно <xrt/xxx.h>. Выбирайте по границе проекта, а не по моде: один заголовок — для прототипов и инструментов, библиотеки — для продуктовых сборок.

Система обрезки возможностей

Обрезка работает в единицах макросов модулей: после определения XRT_MODULE_<NAME> заголовок include/xrt/features.h (генерируется из modules.json скриптом tools/generate_features.py) автоматически разворачивает замыкание зависимостей и выставляет соответствующие макросы XRT_FEATURE_*; отсутствующая зависимость даёт прямой #error в заголовке.

/* Только TCP-сеть и корутины */
#define XRT_MODULE_NET_TCP
#define XRT_MODULE_COROUTINE
#include "xrt.h"

/* Включить всё */
/* #define XRT_MODULE_ALL */

Корректность обрезки охраняют два шлюза:

• Обратная проверка обрезки (build.py --trim-only): для каждого модуля его прямые макросы зависимостей намеренно убираются, и компиляция обязана упасть — защита от пропущенных стражей.
• Запрет символов (measure_size.py): минимальный артефакт обрезки ядра не должен содержать символы с префиксами xrtNet / xrtHttp / xrtWs / xrtTls / xrtRegex — бинарная профилактика расползания возможностей.

У расширений параллельная система макросов (XHTTP_MODULE_*, XWS_MODULE_*…), генерируемая generate_extension_features.py и цепляющая макросы модулей ядра как требования.

Знакомство с XRT

XRT — системная кроссплатформенная библиотека C-инфраструктуры, целью которой является полный инфраструктурный цикл с нулём сторонних рантайм-зависимостей для эпохи Интернета и ИИ. С версии 2.0 репозиторий делится на две части:

• Ядро (src/ + include/xrt/): конкурентные корутины, сетевой движок с пятью бэкендами, TLS, протокольное ядро HTTP/WebSocket, память и контейнеры, файлы и процессы, regex и сопоставление с образцом. 94 публичный заголовок; манифесты модулей объявляют 386 различных макросов возможностей.
• Библиотеки расширения (extlibs/): пять независимых продуктов по доменам — xhttp, xws, xruntime, xmail, xssh. Каждая — самодостаточный мини-проект (свои src / include / tests / examples / config / single) с односторонней зависимостью от ядра. Библиотека xregex влита в модуль ядра regex.

Две формы потребления: модульные исходники / статическая библиотека / динамическая библиотека или самодостаточный один заголовок (у ядра и у каждого расширения — свой).

Обзор репозитория

Модели конкурентности: выбирайте по задаче — используйте всё или ничего

Потоки, корутины, Channel, Future, группы задач и токены отмены решают разные границы. Сперва решите, нужны ли работе настоящий параллелизм, ожидание IO, передача сообщений, композиция результатов или скоординированная остановка; затем возьмите минимальный набор механизмов.

Карта модулей ядра

Быстрый поиск модулей по системам (публичные заголовки в include/xrt/; полная документация по каждому API — в справочнике API):

Путеводитель по библиотекам расширения

Каждое расширение делит одно устройство каталогов: src/ include/ tests/ examples/ bench/ config/modules.json single/ docs/. Публичные заголовки остаются в пространстве имён xrt/ и бесшовно сшиваются с заголовками ядра.

Как устроены тесты и примеры

Суффиксы имён тестовых файлов кодируют измерение теста, и один контракт появляется в нескольких вариантах (напр. test_http_client_iocp.c — это одна строка #define + #include "test_http_client.c"):

Ядро и пять расширений дают 680 примеров на C и 2,512 тестовых файлов на C. Используйте манифесты модулей для поиска исходников и точек входа сборки, затем идите по потокам вызовов в реализацию.

Предлагаемый путь обучения

1. Заставьте сборку работать: python tools/build.py --suite core; наблюдайте инкременты по отпечаткам и вывод тестов.
2. Читайте примеры: возьмите main.c из examples/ по интересующему модулю; поймите сборку, вызовы и высвобождение ресурсов.
3. Читайте тесты: сверьтесь с утверждениями в tests/<module>/, чтобы понять поведение интерфейсов и граничные условия.
4. Попробуйте обрезку: макросами XRT_MODULE_* вырежьте свой минимальный набор и проверьте через --trim-only.

Полезные ссылки

• Репозиторий Gitee — исходники и трекер задач
• Справочник API — документация по API 96 модулей
• Обзор архитектуры — слоистость ядра и расширений