Skip to main content

Create ROS2 lifecycle package boilerplate from a minimal config file

Project description

ROS2 lifecycle package creator

Generate boilerplate source, CMakeLists.txt, launch, package.xml and readme files for ROS2 lifecycle nodes upto a minimum compilable package.

This package works best with standard ROS2 messages and for custom interfaces follow the naming conventions like in ROS2 official packages.

Install and run locally using poetry

  • make sure poetry is installed, then run
# from top level (same where README.md is located)
poetry install
  • enter the poetry env
eval $(poetry env activate)
  • now run
ros2-lifecycle-pkg-create --help

Run locally without poetry

  • install dependencies
pip install jinja2 pyyaml
  • run
python src/main.py --config example/object_segmenter.yaml --target_dir /path/to/ros2_ws/src/example_pkg

What this package generates

  • node.cpp
  • node.hpp
  • main.cpp executable
  • node.launch.py with activated node
  • package.xml with required subscriber and publisher dependencies
  • CMakeLists.txt with required subscriber and publisher dependencies
  • README.md with provided subscriber and publisher data
  • adds .clang-format file as provided in repo here

Setup

config_file

author: authors name
email: authors_email
license: license_name
node_name: NodeName
namespace: some_namespace
description: some description
subscribers:
  topic1: type1
  topic2: type2
publishers:
  topic3: type3
  topic4: type4

Susbcribers and publishers will have handles that will have names topic1_sub_ or topic3_pub_ respectively. Topics will be named exactly as they are specified. eg: topic1

target_dir

The package files will be put in target_dir ensure its empty or doesnt exist (will be created)

TODO

  • add license file
  • add license header
  • add parameter helpers
  • add actions and services

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ros2_lifecycle_package_creator-0.1.2.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file ros2_lifecycle_package_creator-0.1.2.tar.gz.

File metadata

  • Download URL: ros2_lifecycle_package_creator-0.1.2.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.10.16 Linux/6.8.0-1021-azure

File hashes

Hashes for ros2_lifecycle_package_creator-0.1.2.tar.gz
Algorithm Hash digest
SHA256 359a3c1e5a61f8395a53ac62f991761673e53a7595c2148cfaf91d0c082d14ed
MD5 48c62b42d6004ed42b2462b75f5a1ae5
BLAKE2b-256 f9c938c00992ddfaa8bf6789ac89cc5d27a82eb5274cb1506f8accbc9f2f39e0

See more details on using hashes here.

File details

Details for the file ros2_lifecycle_package_creator-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for ros2_lifecycle_package_creator-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3b2cd8508d4d4a157a3f781678aa5029b8dbec7c2b524c25a75ea601404b8aa4
MD5 6a98d14b816db7be4e3d18ffe9e6b892
BLAKE2b-256 82bdbb0c8b43393c045c44502166a61af3274b965e33ba8a0bea02b598347010

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page