Minimal C++ RPC PoC with Auto-Code Generation

Простой Proof-of-Concept реализации RPC для C++ с автоматической генерацией прокси и скелета по аннотациям в исходниках.

Проект демонстрирует:

• Парсинг исходников C++ с помощью libclang для поиска аннотированных классов и методов.
• Автоматическую генерацию файлов:
  • *.proxy.h/cpp — клиентский прокси для вызова удалённых методов.
  • *.skeleton.h/cpp — серверный скелет для приёма запросов и вызова реальных методов.
• Минимальный протокол передачи данных через именованные каналы (FIFO).
• Поддержка только типов int для аргументов и возвращаемого значения (PoC).

---

Структура проекта

project/
├── CMakeLists.txt
├── README.md
├── src
│   ├── client.cpp
│   ├── MyService.cpp
│   ├── MyService.h
│   ├── rpc_common.h
│   ├── rpc_export.h
│   └── server.cpp
├── tools
│   ├── generate_rpc.py
│   └── templates
│       ├── proxy.cpp.j2
│       ├── proxy.h.j2
│       ├── skeleton.cpp.j2
│       └── skeleton.h.j2
└─ build/  # создаётся при сборке

---

Зависимости

• CMake ≥ 3.10

• GCC или Clang с поддержкой C++17

• Python 3.8+ с пакетами:

  pip3 install jinja2 clang
  

• libclang (для Python) Если GCC используется только для сборки — libclang нужен только для генератора.

Важно: Сам libclang и пакет clang для Python должны быть одной версии.

---

Аннотации для экспорта

Управление тем, какие атрибуты каких классов следует экспортировать происходит с помощью аннотаций в исходном коде.

См. файл MyService.h:

class RPC_EXPORT MyService {
public:
    RPC_EXPORT
    int add(int a, int b);
    int minus(int a, int b);
};

• Экспортируем класс MyService:
  • Экспортируем метод MyService::add;
  • Но не экспортируем метод MyService::minus.

---

Сборка проекта

1. Конфигурируем CMake:

cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -B build

Директива CMAKE_EXPORT_COMPILE_COMMANDS=ON нужна для корректного парсинга в libclang.

2. Собираем проект:

cmake --build build

В результате получаем два бинарника:

./build/server
./build/client

---

Генерация кода

Автоматическая генерация прокси и скелета происходит при сборке через Python-скрипт tools/generate_rpc.py.

Пример ручного запуска генератора:

python3 tools/generate_rpc.py \
    --out-dir build/generated \
    --compile-commands build/compile_commands.json \
    src/MyService.h

Сгенерированные файлы попадут в:

build/generated/
├─ MyService.proxy.h
├─ MyService.proxy.cpp
├─ MyService.skeleton.h
└─ MyService.skeleton.cpp

---

Запуск

1. В одном терминале запускаем сервер:

./server

2. В другом терминале — клиент:

./client

Ожидаемый вывод:

RESULT: 15