mirror of
https://github.com/logos-co/logos-cpp-sdk.git
synced 2026-08-30 01:01:12 +00:00
* feat: cpp-generator consumes logos-lidl; delete embedded frontend The canonical LIDL frontend now lives in logos-lidl. cpp-generator links it and keeps only the C++/Qt-specific parts (impl-header parsing, the gen_client/ gen_cdylib backends, the Qt type-name mapping). - Delete the embedded lidl_lexer/parser/serializer/validator/ast. - Add experimental/lidl_compat.h: brings logos-lidl's std AST into the global scope the backends use (via `using`), a qs() std::string→QString helper, a QTextStream<<std::string overload, and name-compatible shims (lidlParse/ lidlSerialize/lidlValidate) so the emission code keeps compiling. - Re-point impl_header_parser, lidl_gen_client (+ Doxygen /// docs on the generated client methods), lidl_gen_cdylib, lidl_emit_common, and legacy/ main at lidl::ModuleDecl. - CMake: C++17 + find_package(logos-lidl) + link logos-lidl::logos_lidl. - bin.nix: distribute only the shared C++/Qt backend helpers (compat + impl_header_parser + emit_common) under share/lidl-frontend, not the frontend. - tests: drop the 4 frontend test files (covered by logos-lidl now); the backend tests link logos-lidl. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix: pin logos-lidl to the C-ABI commit + lock it The logos-lidl input was declared in flake.nix but missing from flake.lock, so override chains that don't reach the nested input (the doctest harness building a scaffolded module) couldn't resolve it. Pin the branch rev and lock it so the component is self-contained. Re-point at master once logos-lidl lands. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * chore: re-point logos-lidl to merged master (#5) --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
332 lines
15 KiB
C++
332 lines
15 KiB
C++
#include "legacy/legacy_main.h"
|
|
#include "experimental/lidl_gen_client.h"
|
|
#include "experimental/lidl_gen_cdylib.h"
|
|
#include "experimental/lidl_compat.h"
|
|
#include "experimental/impl_header_parser.h"
|
|
|
|
#include <QCoreApplication>
|
|
#include <QDir>
|
|
#include <QFile>
|
|
#include <QFileInfo>
|
|
#include <QTextStream>
|
|
|
|
int main(int argc, char* argv[])
|
|
{
|
|
// Check for --lidl / --from-header / --header-to-lidl mode before
|
|
// initializing QCoreApplication, since legacy_main creates its own.
|
|
bool hasLidl = false;
|
|
bool hasFromHeader = false;
|
|
bool hasHeaderToLidl = false;
|
|
for (int i = 1; i < argc; ++i) {
|
|
QString arg = QString::fromUtf8(argv[i]);
|
|
if (arg == "--lidl") hasLidl = true;
|
|
if (arg == "--from-header") hasFromHeader = true;
|
|
if (arg == "--header-to-lidl") hasHeaderToLidl = true;
|
|
}
|
|
|
|
// --header-to-lidl: the C++ frontend of the source -> LIDL -> bindings
|
|
// pipeline. Parse an impl header and emit ONLY its LIDL contract (no Qt
|
|
// glue / dispatch), so a module can publish a cheap `lidl` artifact that
|
|
// consumers (any language) turn into bindings without building the module.
|
|
if (hasHeaderToLidl) {
|
|
QCoreApplication app(argc, argv);
|
|
QTextStream err(stderr);
|
|
QTextStream out(stdout);
|
|
const QStringList args = app.arguments();
|
|
|
|
// Strip a leading '@' from path arguments — some build drivers pass
|
|
// `@/abs/path`. Matches the legacy_main path handling.
|
|
auto stripAt = [](QString p) { if (p.startsWith('@')) p.remove(0, 1); return p; };
|
|
|
|
const int idx = args.indexOf("--header-to-lidl");
|
|
if (idx + 1 >= args.size()) {
|
|
err << "Error: --header-to-lidl requires a path to the impl header\n";
|
|
return 1;
|
|
}
|
|
const QString headerPath = stripAt(args.at(idx + 1));
|
|
|
|
const int implClassIdx = args.indexOf("--impl-class");
|
|
if (implClassIdx == -1 || implClassIdx + 1 >= args.size()) {
|
|
err << "Error: --header-to-lidl requires --impl-class <ClassName>\n";
|
|
return 1;
|
|
}
|
|
const QString implClass = args.at(implClassIdx + 1);
|
|
|
|
const int metadataIdx = args.indexOf("--metadata");
|
|
if (metadataIdx == -1 || metadataIdx + 1 >= args.size()) {
|
|
err << "Error: --header-to-lidl requires --metadata <metadata.json>\n";
|
|
return 1;
|
|
}
|
|
const QString metadataPath = stripAt(args.at(metadataIdx + 1));
|
|
|
|
ImplParseResult pr = parseImplHeader(headerPath, implClass, metadataPath, err);
|
|
if (pr.hasError()) {
|
|
err << "Error parsing impl header: " << pr.error << "\n";
|
|
return 4;
|
|
}
|
|
const ModuleDecl& mod = pr.module;
|
|
|
|
// Output path: explicit -o/--output <file>, else <output-dir>/<name>.lidl,
|
|
// else <name>.lidl in the CWD.
|
|
QString outPath;
|
|
const int oIdx = args.indexOf("-o");
|
|
const int outputIdx = args.indexOf("--output");
|
|
const int outDirIdx = args.indexOf("--output-dir");
|
|
if (oIdx != -1 && oIdx + 1 < args.size()) {
|
|
outPath = stripAt(args.at(oIdx + 1));
|
|
} else if (outputIdx != -1 && outputIdx + 1 < args.size()) {
|
|
outPath = stripAt(args.at(outputIdx + 1));
|
|
} else if (outDirIdx != -1 && outDirIdx + 1 < args.size()) {
|
|
const QString d = stripAt(args.at(outDirIdx + 1));
|
|
QDir().mkpath(d);
|
|
outPath = QDir(d).filePath(qs(mod.name) + ".lidl");
|
|
} else {
|
|
outPath = qs(mod.name) + ".lidl";
|
|
}
|
|
|
|
QFile f(outPath);
|
|
if (!f.open(QIODevice::WriteOnly | QIODevice::Truncate | QIODevice::Text)) {
|
|
err << "Failed to write LIDL: " << outPath << "\n";
|
|
return 5;
|
|
}
|
|
f.write(lidlSerialize(mod).toUtf8());
|
|
f.close();
|
|
out << "Generated LIDL: " << outPath << " (" << mod.methods.size()
|
|
<< " methods, " << mod.events.size() << " events)\n";
|
|
out.flush();
|
|
return 0;
|
|
}
|
|
|
|
if (hasLidl || hasFromHeader) {
|
|
QCoreApplication app(argc, argv);
|
|
QTextStream err(stderr);
|
|
QTextStream out(stdout);
|
|
const QStringList args = app.arguments();
|
|
|
|
QString outputDir;
|
|
const int outDirIdx = args.indexOf("--output-dir");
|
|
if (outDirIdx != -1 && outDirIdx + 1 < args.size()) {
|
|
outputDir = args.at(outDirIdx + 1);
|
|
}
|
|
|
|
// --from-header mode: parse C++ impl header directly (no .lidl needed)
|
|
if (hasFromHeader) {
|
|
const int fromHeaderIdx = args.indexOf("--from-header");
|
|
if (fromHeaderIdx + 1 >= args.size()) {
|
|
err << "Error: --from-header requires a path to the impl header\n";
|
|
return 1;
|
|
}
|
|
QString headerPath = args.at(fromHeaderIdx + 1);
|
|
|
|
const int implClassIdx = args.indexOf("--impl-class");
|
|
if (implClassIdx == -1 || implClassIdx + 1 >= args.size()) {
|
|
err << "Error: --from-header requires --impl-class <ClassName>\n";
|
|
return 1;
|
|
}
|
|
QString implClass = args.at(implClassIdx + 1);
|
|
|
|
const int metadataIdx = args.indexOf("--metadata");
|
|
if (metadataIdx == -1 || metadataIdx + 1 >= args.size()) {
|
|
err << "Error: --from-header requires --metadata <metadata.json>\n";
|
|
return 1;
|
|
}
|
|
QString metadataPath = args.at(metadataIdx + 1);
|
|
|
|
// --impl-header: the include path for generated code (defaults to header filename)
|
|
QString implHeader;
|
|
const int implHeaderIdx = args.indexOf("--impl-header");
|
|
if (implHeaderIdx != -1 && implHeaderIdx + 1 < args.size()) {
|
|
implHeader = args.at(implHeaderIdx + 1);
|
|
} else {
|
|
implHeader = QFileInfo(headerPath).fileName();
|
|
}
|
|
|
|
const int backendIdx = args.indexOf("--backend");
|
|
if (backendIdx == -1 || backendIdx + 1 >= args.size()) {
|
|
err << "Error: --from-header requires --backend <qt>\n";
|
|
return 1;
|
|
}
|
|
QString backend = args.at(backendIdx + 1);
|
|
|
|
// Parse the impl header
|
|
ImplParseResult pr = parseImplHeader(headerPath, implClass, metadataPath, err);
|
|
if (pr.hasError()) {
|
|
err << "Error parsing impl header: " << pr.error << "\n";
|
|
return 4;
|
|
}
|
|
|
|
const ModuleDecl& mod = pr.module;
|
|
QString genDirPath = outputDir.isEmpty()
|
|
? QDir::current().filePath("generated")
|
|
: outputDir;
|
|
QDir().mkpath(genDirPath);
|
|
|
|
if (backend == "cdylib") {
|
|
// Cdylib authoring: the common module-impl C ABI exports +
|
|
// the uniform Qt-plugin glue (language-agnostic, forwards to
|
|
// the C symbols). See logos_module_impl.h in logos-protocol.
|
|
QString cdErr;
|
|
if (!lidlCdylibSupported(mod, &cdErr)) {
|
|
err << "Error: module not cdylib-eligible: " << cdErr << "\n";
|
|
return 10;
|
|
}
|
|
struct Out { QString file; QString content; };
|
|
QList<Out> outs;
|
|
outs.append({qs(mod.name) + "_module_impl.cpp",
|
|
lidlMakeModuleImplExports(mod, implClass, implHeader)});
|
|
if (!mod.events.empty())
|
|
outs.append({qs(mod.name) + "_events_cdylib.cpp",
|
|
lidlMakeEventsSourceCdylib(mod, implClass, implHeader)});
|
|
outs.append({qs(mod.name) + ".lidl", lidlSerialize(mod)});
|
|
for (const Out& o : outs) {
|
|
const QString abs = QDir(genDirPath).filePath(o.file);
|
|
QFile f(abs);
|
|
if (!f.open(QIODevice::WriteOnly | QIODevice::Truncate | QIODevice::Text)) {
|
|
err << "Failed to write: " << abs << "\n";
|
|
return 11;
|
|
}
|
|
f.write(o.content.toUtf8());
|
|
out << "Generated: " << abs << "\n";
|
|
}
|
|
out.flush();
|
|
return 0;
|
|
}
|
|
|
|
if (backend == "qt") {
|
|
err << "Error: Qt glue generation moved to logos-qt-generator "
|
|
"(logos-qt-sdk). Use it for --backend qt; this tool "
|
|
"keeps the Qt-free outputs (--header-to-lidl emits the "
|
|
".lidl sidecar).\n";
|
|
return 6;
|
|
}
|
|
|
|
err << "Error: --from-header supports --backend cdylib (Qt glue: logos-qt-generator)\n";
|
|
return 1;
|
|
}
|
|
|
|
// --lidl mode
|
|
const int lidlIdx = args.indexOf("--lidl");
|
|
if (lidlIdx + 1 >= args.size()) {
|
|
err << "Usage: " << QFileInfo(app.applicationFilePath()).fileName()
|
|
<< " --lidl /path/to/module.lidl [--output-dir /path] [--module-only]\n"
|
|
<< " " << QFileInfo(app.applicationFilePath()).fileName()
|
|
<< " --lidl /path/to/module.lidl --backend qt --impl-class Class --impl-header header.h [--output-dir /path]\n"
|
|
<< " " << QFileInfo(app.applicationFilePath()).fileName()
|
|
<< " --lidl /path/to/module.lidl --backend cdylib [--output-dir /path] (glue-only: C exports come from the module's own language backend)\n"
|
|
<< " " << QFileInfo(app.applicationFilePath()).fileName()
|
|
<< " --from-header src/impl.h --backend qt --impl-class Class --metadata metadata.json [--output-dir /path]\n";
|
|
return 1;
|
|
}
|
|
QString lidlPath = args.at(lidlIdx + 1);
|
|
|
|
// Provider glue mode: --backend qt --impl-class X --impl-header Y
|
|
const int backendIdx = args.indexOf("--backend");
|
|
if (backendIdx != -1) {
|
|
if (backendIdx + 1 >= args.size()) {
|
|
err << "Error: --backend requires an argument (e.g., qt)\n";
|
|
return 1;
|
|
}
|
|
QString backend = args.at(backendIdx + 1);
|
|
|
|
const int implClassIdx = args.indexOf("--impl-class");
|
|
const int implHeaderIdx = args.indexOf("--impl-header");
|
|
|
|
// Cdylib-from-LIDL (contract-first):
|
|
// - with no --impl-class: GLUE-ONLY — the C exports come from
|
|
// the module's own language backend (e.g. the Rust SDK's
|
|
// lidl-gen --provider); the glue only knows the C symbols.
|
|
// - with --impl-class/--impl-header: the FULL set — the C-ABI
|
|
// export wrapper around the named (hand-written, Qt-free)
|
|
// C++ impl class, plus the same uniform glue. The contract
|
|
// stays the .lidl; the author just implements the class.
|
|
if (backend == "cdylib") {
|
|
QFile f(lidlPath);
|
|
if (!f.open(QIODevice::ReadOnly | QIODevice::Text)) {
|
|
err << "Error: cannot read " << lidlPath << "\n";
|
|
return 1;
|
|
}
|
|
LidlParseResult pr = lidlParse(QString::fromUtf8(f.readAll()));
|
|
if (pr.hasError()) {
|
|
err << "Error parsing " << lidlPath << ": " << pr.error
|
|
<< " (line " << pr.errorLine << ")\n";
|
|
return 4;
|
|
}
|
|
const ModuleDecl& mod = pr.module;
|
|
QString cdErr;
|
|
if (!lidlCdylibSupported(mod, &cdErr)) {
|
|
err << "Error: module not cdylib-eligible: " << cdErr << "\n";
|
|
return 10;
|
|
}
|
|
QString genDirPath = outputDir.isEmpty()
|
|
? QDir::current().filePath("generated")
|
|
: outputDir;
|
|
QDir().mkpath(genDirPath);
|
|
struct Out { QString file; QString content; };
|
|
QList<Out> outs;
|
|
if (implClassIdx != -1) {
|
|
if (implClassIdx + 1 >= args.size()) {
|
|
err << "Error: --impl-class requires a class name\n";
|
|
return 1;
|
|
}
|
|
const QString implClass = args.at(implClassIdx + 1);
|
|
QString implHeader;
|
|
if (implHeaderIdx != -1 && implHeaderIdx + 1 < args.size())
|
|
implHeader = args.at(implHeaderIdx + 1);
|
|
else
|
|
implHeader = qs(mod.name) + "_impl.h";
|
|
outs.append({qs(mod.name) + "_module_impl.cpp",
|
|
lidlMakeModuleImplExports(mod, implClass, implHeader)});
|
|
if (!mod.events.empty())
|
|
outs.append({qs(mod.name) + "_events_cdylib.cpp",
|
|
lidlMakeEventsSourceCdylib(mod, implClass, implHeader)});
|
|
} else {
|
|
err << "Error: the uniform cdylib Qt glue is generated by "
|
|
"logos-qt-generator (logos-qt-sdk); this tool emits "
|
|
"the Qt-free C-ABI export wrapper, which requires "
|
|
"--impl-class.\n";
|
|
return 12;
|
|
}
|
|
for (const Out& o : outs) {
|
|
const QString abs = QDir(genDirPath).filePath(o.file);
|
|
QFile of(abs);
|
|
if (!of.open(QIODevice::WriteOnly | QIODevice::Truncate | QIODevice::Text)) {
|
|
err << "Failed to write: " << abs << "\n";
|
|
return 11;
|
|
}
|
|
of.write(o.content.toUtf8());
|
|
out << "Generated: " << abs << "\n";
|
|
}
|
|
out.flush();
|
|
return 0;
|
|
}
|
|
|
|
if (implClassIdx == -1 || implClassIdx + 1 >= args.size()) {
|
|
err << "Error: --backend " << backend << " requires --impl-class <ClassName>\n";
|
|
return 1;
|
|
}
|
|
if (implHeaderIdx == -1 || implHeaderIdx + 1 >= args.size()) {
|
|
err << "Error: --backend " << backend << " requires --impl-header <header.h>\n";
|
|
return 1;
|
|
}
|
|
|
|
QString implClass = args.at(implClassIdx + 1);
|
|
QString implHeader = args.at(implHeaderIdx + 1);
|
|
|
|
if (backend == "qt") {
|
|
err << "Error: Qt glue generation moved to logos-qt-generator "
|
|
"(logos-qt-sdk).\n";
|
|
return 6;
|
|
}
|
|
|
|
err << "Error: unsupported backend '" << backend << "' (supported: cdylib)\n";
|
|
return 1;
|
|
}
|
|
|
|
// Client stub mode (default)
|
|
bool moduleOnly = args.contains("--module-only");
|
|
return lidlGenerateClientStubs(lidlPath, outputDir, moduleOnly, out, err);
|
|
}
|
|
|
|
return legacy_main(argc, argv);
|
|
}
|