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.3.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.

ros2_lifecycle_package_creator-0.1.3-py3-none-any.whl (14.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ros2_lifecycle_package_creator-0.1.3.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.3.tar.gz
Algorithm Hash digest
SHA256 a98f2a6c1dd832a7b5df0f4a8d0ce82d48187fae530630c6fb8d299846e38f51
MD5 af5176f740fcfa6ef0591c0065c7685c
BLAKE2b-256 b23242bbf012b622e9169ab2e9316e7b937cb0b6b3813d27474d6ea3ba5cd916

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for ros2_lifecycle_package_creator-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 469cbce60a79fc51e8c7540cbfa7b2711415dbb0cfe0d706dbc23c6e85390825
MD5 011bf31d941edb5d5ad5b4a4124c8bee
BLAKE2b-256 2c16b93b59a6acf719af290dd71289f09b00043a9214f1554e494d56179ce9d9

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