rustecal meta crate introduced

Meta crate

Author: rex-schilasky

.gitignore

@@ -1,2 +1,3 @@
+/.idea
 /target
 Cargo.lock

Cargo.toml

@@ -1,6 +1,9 @@
 [workspace]
 members = [
     "rustecal",
+    "rustecal-core",
+    "rustecal-pubsub",
+    "rustecal-service",
     "rustecal-sys",
     "rustecal-types-bytes",
     "rustecal-types-protobuf",

README.md

@@ -127,6 +127,7 @@ fn main() {
 
         std::thread::sleep(std::time::Duration::from_secs(1));
     }
+
     Ecal::finalize();
 }
 ```

docs/src/project_structure.md

@@ -1,29 +1,41 @@
 # Project Structure
 
-| Crate | Description |
-|-------|-------------|
-| `rustecal-sys` | Low-level unsafe bindings (via `bindgen`) |
-| `rustecal` | Safe and idiomatic high-level wrapper |
-| `rustecal-types-bytes` | Support for raw byte messages |
-| `rustecal-types-string` | UTF-8 string message support |
-| `rustecal-types-protobuf` | Protobuf support using `prost` |
-| `rustecal-samples` | Working binary examples |
+This workspace is organized into several purpose-specific crates to provide a modular, maintainable API for eCAL:
+
+| Crate                     | Description                                              |
+|---------------------------|----------------------------------------------------------|
+| `rustecal`                | **Meta‑crate**: re‑exports core, pub/sub, and service APIs via feature flags (`pubsub`, `service`) |
+| `rustecal-core`           | eCAL initialization, shutdown, and shared common types    |
+| `rustecal-pubsub`         | Typed and untyped Publisher/Subscriber API               |
+| `rustecal-service`        | RPC Service server & client API                          |
+| `rustecal-sys`            | Low‑level FFI bindings to the eCAL C API                 |
+| `rustecal-types-string`   | Helper: UTF-8 string message wrapper for typed pub/sub   |
+| `rustecal-types-bytes`    | Helper: raw byte vector message wrapper                  |
+| `rustecal-types-protobuf` | Helper: Protobuf message wrapper (using `prost`)         |
+| `rustecal-samples`        | Example binaries demonstrating pub/sub and RPC usage      |
 
 ## Workspace Layout
 
-```
+```text
 your_workspace/
-├── rustecal/
-├── rustecal-sys/
-├── rustecal-types-bytes/
+├── Cargo.toml              # workspace manifest
+├── rustecal/               # meta‑crate (feature‑gated)
+├── rustecal-core/          # core init + types
+├── rustecal-pubsub/        # pub/sub API
+├── rustecal-service/       # service RPC API
+├── rustecal-sys/           # raw C bindings
 ├── rustecal-types-string/
+├── rustecal-types-bytes/
 ├── rustecal-types-protobuf/
-└── rustecal-samples/
-    └── pubsub/
-        ├── blob_send/
-        ├── blob_receive/
-        ├── hello_send/
-        ├── hello_receive/
-        ├── person_send/
-        └── person_receive/
-```
+└── rustecal-samples/       # examples
+    ├── pubsub/
+    │   ├── hello_send/
+    │   ├── hello_receive/
+    │   ├── blob_send/
+    │   ├── blob_receive/
+    │   ├── person_send/
+    │   └── person_receive/
+    └── service/
+        ├── mirror_server/
+        ├── mirror_client/
+        └── mirror_client_instances/

rustecal-core/Cargo.toml

@@ -0,0 +1,14 @@
+[package]
+name = "rustecal-core"
+version = "0.1.0"
+edition = "2021"
+publish = false
+
+[dependencies]
+rustecal-sys = { path = "../rustecal-sys" }
+once_cell     = "1.17"
+thiserror     = "1.0"
+bitflags      = "1.3"
+
+[features]
+default = []

rustecal/src/ecal/components.rs rustecal-core/src/components.rsrustecal/src/ecal/components.rs renamed to rustecal-core/src/components.rs

@@ -12,7 +12,7 @@
 //! application and [`Ecal::finalize`] at shutdown.
 
 use std::ffi::CString;
-use crate::ecal::components::EcalComponents;
+use crate::components::EcalComponents;
 use rustecal_sys;
 
 /// Provides access to the core initialization and finalization functions of eCAL.

rustecal/src/ecal/core.rs rustecal-core/src/core.rsrustecal/src/ecal/core.rs renamed to rustecal-core/src/core.rs

@@ -0,0 +1,9 @@
+//! rustecal-core: eCAL initialization & shared types
+
+pub mod core;
+pub mod components;
+pub mod types;
+
+// Re‑exports for ergonomic access:
+pub use core::Ecal;
+pub use components::EcalComponents;

rustecal-core/src/lib.rs

@@ -0,0 +1,14 @@
+[package]
+name = "rustecal-pubsub"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+rustecal-sys = { path = "../rustecal-sys" }
+rustecal-core = { path = "../rustecal-core" }
+thiserror     = "1.0"
+serde         = { version = "1.0", optional = true }
+
+[features]
+default       = []
+serde-support = ["serde"]