zerodds_corba_ir/lib.rs
1// SPDX-License-Identifier: Apache-2.0
2// Copyright 2026 ZeroDDS Contributors
3
4//! OMG CORBA 3.3 Part 1 §14 — Interface Repository (IR).
5//!
6//! Crate `zerodds-corba-ir`. Safety classification: **STANDARD**.
7//! `no_std + alloc`, `forbid(unsafe_code)`.
8//!
9//! Voller IR-Stack: TypeCode (alle 32 TCKinds — `tk_null` … `tk_local_interface`),
10//! Repository mit Containment-Hierarchie (`Container`/`Definition`/`Module`),
11//! `DefinitionKind` (`dk_*`-Konstanten), strukturierte `RepositoryId`
12//! mit Spec-§10.7.3.1-Format-Parser/Builder.
13//!
14//! ## Public API (Stand 1.0.0-rc.1)
15//!
16//! - [`RepositoryId`] — `IDL:<scoped>:<major>.<minor>` Parser/Builder.
17//! - [`TypeCode`] / [`TcKind`] / [`UnionMember`] — TypeCode-Modell.
18//! - [`Repository`] / [`Container`] / [`Definition`] / [`Module`] — IR-Hierarchie.
19//! - [`DefinitionKind`] — `dk_None` … `dk_LocalInterface`.
20//! - [`IrError`] / [`IrResult`] — Repository-Fehler.
21//!
22//! ## Konsumenten
23//!
24//! - [`zerodds_corba_poa`] verwendet `RepositoryId::parse` zur typisierten
25//! Validierung von Servant-Interfaces (Spec §11.3.5.20.4 `_is_a`).
26//! - Externe CORBA-Anwendungen konsumieren den IR via IIOP/IOR.
27//!
28//! ## Beispiel
29//!
30//! ```
31//! use zerodds_corba_ir::RepositoryId;
32//! let r = RepositoryId::parse("IDL:omg.org/CosNaming/NamingContext:1.0").unwrap();
33//! assert_eq!(r.scoped_name, "omg.org/CosNaming/NamingContext");
34//! assert_eq!(r.major, 1);
35//! assert_eq!(r.minor, 0);
36//! ```
37
38#![cfg_attr(not(feature = "std"), no_std)]
39#![forbid(unsafe_code)]
40#![warn(missing_docs)]
41
42#[cfg(feature = "alloc")]
43extern crate alloc;
44
45pub mod definition_kind;
46pub mod error;
47pub mod repository;
48pub mod repository_id;
49pub mod type_code;
50
51pub use definition_kind::DefinitionKind;
52pub use error::{IrError, IrResult};
53pub use repository::{Container, Definition, Module, Repository};
54pub use repository_id::RepositoryId;
55pub use type_code::{TcKind, TypeCode, UnionMember};