ros2forge 0.4.2

ROS2 workspace scaffolder + multi-machine diagnostics toolkit

rosforge

ROS2 workspace scaffolder + multi-machine diagnostics toolkit.

Two tools. One install.

---

Install

pip install ros2forge

Or from source:

git clone https://github.com/emphiasarmlorn/ros2forge
cd rosforge && pip install -e .

---

rosforge scaf

Scaffold a complete ROS2 workspace interactively:

rosforge scaf

Generates:

• config/cyclonedds.xml or fastdds.xml — correct for your network topology
• config/bashrc_block.sh — exact exports, ready to paste
• scripts/install_device1.sh, install_device2.sh — full per-device install scripts
• src/<pkg>/<node>.py — publisher / subscriber / service node, colcon-ready
• package.xml, setup.py
• README.md with device-specific steps

Supports: Humble / Iron / Jazzy / Rolling, RPi / Jetson / x86 / STM32, CycloneDDS / FastDDS, same LAN / cross-subnet / hotspot / single machine, micro-ROS agent config.

---

rosforge doctor

Diagnose your ROS2 multi-machine setup:

# Local checks only
rosforge doctor

# Check peer connectivity too
rosforge doctor raspberrypi.local 192.168.1.42

Checks:

• ROS2 installation and distro detection
• RMW / DDS environment variables
• ROS_DOMAIN_ID and ROS_LOCALHOST_ONLY
• Network interface enumeration
• Multicast reachability
• UFW / iptables firewall rules blocking UDP
• DDS port availability (7400–7411)
• NTP clock synchronization
• ROS2 daemon health
• Cross-distro compatibility warnings
• Live topic discovery smoke-test
• Per-peer: ICMP ping + UDP reachability

Every failure comes with a specific fix command.

---

Workflow

# 1. Scaffold your workspace
rosforge scaf

# 2. Diagnose immediately after
rosforge doctor raspberrypi.local jetson.local

# 3. Apply fixes, re-run until clean
rosforge doctor

---

License

MIT