zerodds-idlc 1.0.0-rc.5

ZeroDDS IDL4 compiler CLI — Backends fuer C, C++, C#, Java, Python, Rust ueber zerodds-idl-* Codegen-Crates.
zerodds-idlc-1.0.0-rc.5 is not a library.

zerodds-idlc

ZeroDDS IDL4-Compiler-CLI — uebersetzt OMG IDL 4.2-Specs in Sprach-Bindings fuer C, C++, Rust, TypeScript, C# und Java. Nutzt intern den zerodds-idl-Parser plus die zerodds-idl-<lang>-Codegen- Crates und orchestriert sie ueber einheitliche Flags.

Teil des Projekts ZeroDDS. Safety-Klasse SAFE (std-only) — Build-Zeit-Tool, deterministisch.

Quick Start

# IDL parsen, AST drucken (kein Codegen)
zerodds-idlc --parse-only chat.idl

# IDL → Sprach-Code (eines der sechs Backends)
zerodds-idlc --rust   -o gen/rust   chat.idl     # → gen/rust/chat.rs
zerodds-idlc --c      -o gen/c      chat.idl     # → gen/c/chat.h
zerodds-idlc --cpp    -o gen/cpp    chat.idl     # → gen/cpp/chat.hpp
zerodds-idlc --ts     -o gen/ts     chat.idl     # → gen/ts/chat.ts
zerodds-idlc --csharp -o gen/cs     chat.idl     # → gen/cs/chat.cs
zerodds-idlc --java   -o gen/java   chat.idl     # → gen/java/<pkg>/<Class>.java

--rti aktiviert das RTI-Connext-Grammar-Delta (akzeptiert keylist-Direktive und andere Vendor-Konstrukte) — additiv auf die OMG-IDL-4.2-Base.

Flags

Flag Bedeutung
--parse-only Parse + AST drucken, kein Codegen.
--rti RTI-Connext-Delta zusaetzlich zur OMG-IDL-4.2-Base laden.
--c C-Header-Backend (zerodds-idl-cpp::c_mode).
--cpp C++17-Header-Backend (zerodds-idl-cpp).
--rust Rust-Modul-Backend (zerodds-idl-rust).
--ts TypeScript-Backend (zerodds-idl-ts).
--csharp C#-Backend (zerodds-idl-csharp).
--java Java-Backend (zerodds-idl-java) — Multi-File-Output im Package-Layout.
-o, --output DIR Ausgabe-Verzeichnis. Pflicht fuer alle Backend-Modi.
-h, --help Hilfetext.
-V, --version Versions-Info.

--parse-only und Backend-Flags sind mutually exclusive. Es darf nur ein Backend pro Aufruf gewaehlt sein.

Backends

Flag Output Library-Crate Spec
--c <dir>/<base>.h zerodds-idl-cpp::c_mode ZeroDDS-C-Convention
--cpp <dir>/<base>.hpp zerodds-idl-cpp OMG IDL4-CPP, DDS-PSM-CXX
--rust <dir>/<base>.rs zerodds-idl-rust ZeroDDS-IDL-Rust 1.0
--ts <dir>/<base>.ts zerodds-idl-ts ZeroDDS DDS-TS 1.0
--csharp <dir>/<base>.cs zerodds-idl-csharp OMG IDL4-CSharp
--java <dir>/<pkg/path>/<Class>.java zerodds-idl-java OMG IDL4-Java, DDS-Java-PSM

Python ist (noch) nicht enthalten. Die Python-Binding-Crate (crates/py) nutzt laut Vendor-Spec zerodds-py-1.0 den codegen- freien @idl_struct-Decorator-Pfad — ein separates zerodds-idl- python-Crate ist Roadmap-Material.

Exit-Codes

Code Bedeutung
0 Erfolg
1 Parse-Fehler (Lex / Recognize / Build)
2 CLI-/IO-Fehler (Args, Datei nicht lesbar, fehlendes -o)
3 Backend-Fehler oder Feature noch nicht implementiert

Spec-Mapping

Spec-Dokument Abschnitt
OMG IDL 4.2 (ISO/IEC 19516) §7 — Syntax + Semantik (via zerodds-idl)
OMG DDS-XTypes 1.3 §7.4 — Sprach-Mapping-Regeln (per Backend)

Pro-Sprache-PSM-Specs siehe README der jeweiligen zerodds-idl-<lang>- Crate.

Stabilitaet

1.0.0-rc.2. CLI-Flags und Exit-Codes sind ab 1.0.0-final stabil. Generierter Code pro Sprache ist wire-byte-identisch zu Cyclone DDS / RTI Connext / Fast-DDS.

Tests

cargo test -p zerodds-idlc

17 Unit-Tests pro Backend (Codegen-Erfolg + Symbol-Verifikation) plus CLI-Edge-Cases (mutually-exclusive, missing-output, unknown flags).

See also