Welcome to MsgCenterPy’s Documentation!

MsgCenterPy is a multi-format message conversion system based on a unified instance manager architecture, supporting seamless conversion between ROS2, Pydantic, Dataclass, JSON, Dict, YAML and JSON Schema.

📦 Installation

Basic Installation

pip install msgcenterpy

With Optional Dependencies

# Install ROS2 support
conda install ros-humble-ros-core ros-humble-std-msgs ros-humble-geometry-msgs -c robostack-staging

From Source

git clone https://github.com/ZGCA-Forge/MsgCenterPy.git
cd MsgCenterPy
pip install -e .[dev]

🚀 Quick Start

Basic Usage

from msgcenterpy import MessageInstance, MessageType

# Create message instance from dictionary
data = {
    "name": "sensor_001",
    "readings": [1.0, 2.0, 3.0],
    "active": True
}
dict_instance = MessageInstance.create(MessageType.DICT, data)

# Generate JSON Schema
schema = dict_instance.get_json_schema()
print(schema)