rclcpp_lifecycle

Package containing a prototype for lifecycle implementation.

The link to the latest rclcpp_lifecycle API documentation, which includes a complete list of its main components and features, can be found on the rclcpp_lifecycle package info page. For more information about LifeCycle in ROS 2, see the design document.

Quality Declaration

This package claims to be in the Quality Level 1 category, see the Quality Declaration for more details.

Changelog for package rclcpp_lifecycle

29.1.0 (2024-11-20)

• Fix error message in rclcpp_lifecycle::State::reset() (#2647)
• Contributors: Christophe Bedard

29.0.0 (2024-10-03)

• Shutdown the context before context's destructor is invoked in tests (#2633)
• LifecycleNode bugfix and add test cases (#2562)
• Properly test get_service_names_and_types_by_node in rclcpp_lifecycle (#2599)
• Contributors: Alejandro Hernández Cordero, Christophe Bedard, Tomoya Fujita

28.3.3 (2024-07-29)

28.3.2 (2024-07-24)

• Removed deprecated methods and classes (#2575)

• Fix the lifecycle tests on RHEL-9. (#2583) * Fix the lifecycle tests on RHEL-9. The full explanation is in the comment, but basically since RHEL doesn't support mocking_utils::inject_on_return, we have to split out certain tests to make sure resources within a process don't collide. Co-authored-by: Alejandro Hernández Cordero <<ahcorde@gmail.com>>

• Contributors: Alejandro Hernández Cordero, Chris Lalancette

28.3.1 (2024-06-25)

28.3.0 (2024-06-17)

• revert call shutdown in LifecycleNode destructor (#2557)
• LifecycleNode shutdown on dtor only with valid context. (#2545)
• call shutdown in LifecycleNode dtor to avoid leaving the device in unknown state (2nd) (#2528)
• rclcpp::shutdown should not be called before LifecycleNode dtor. (#2527)
• Revert "call shutdown in LifecycleNode dtor to avoid leaving the device in un… (#2450)" (#2522)
• Add 'mimick' label to tests which use Mimick (#2516)
• Contributors: Chris Lalancette, Scott K Logan, Tomoya Fujita

28.2.0 (2024-04-26)

28.1.0 (2024-04-16)

• Remove references to index.ros.org. (#2504)
• Contributors: Chris Lalancette

28.0.1 (2024-04-16)

• call shutdown in LifecycleNode dtor to avoid leaving the device in un… (#2450)
  • call shutdown in LifecycleNode dtor to avoid leaving the device in unknown state.

  * add test to verify LifecycleNode::shutdown is called on destructor. ---------

• Contributors: Tomoya Fujita

28.0.0 (2024-03-28)

• Update quality declaration documents (#2427)
• Contributors: Christophe Bedard

27.0.0 (2024-02-07)

26.0.0 (2024-01-24)

• Increase timeout for rclcpp_lifecycle to 360 (#2395)
• Contributors: Jorge Perez

25.0.0 (2023-12-26)

24.0.0 (2023-11-06)

• Fix rclcpp_lifecycle inclusion on Windows. (#2331)
• Contributors: Chris Lalancette

23.2.0 (2023-10-09)

• add clients & services count (#2072)
• Contributors: Minju, Lee

23.1.0 (2023-10-04)

23.0.0 (2023-09-08)

• Update API docs links in package READMEs (#2302)
• Contributors: Christophe Bedard

22.2.0 (2023-09-07)

• add logger level service to lifecycle node. (#2277)
• Contributors: Tomoya Fujita

22.1.0 (2023-08-21)

• Stop using constref signature of benchmark DoNotOptimize. (#2238)
• Contributors: Chris Lalancette

22.0.0 (2023-07-11)

• Implement get_node_type_descriptions_interface for lifecyclenode and add smoke test for it (#2237)
• Switch lifecycle to use the RCLCPP macros. (#2233)
• Add new node interface TypeDescriptionsInterface to provide GetTypeDescription service (#2224)
• Contributors: Chris Lalancette, Emerson Knapp

21.3.0 (2023-06-12)

21.2.0 (2023-06-07)

21.1.1 (2023-05-11)

21.1.0 (2023-04-27)

21.0.0 (2023-04-18)

• Add support for logging service. (#2122)
• Support publishing loaned messages in LifecyclePublisher (#2159)
• Contributors: Lei Liu, Michael Babenko

20.0.0 (2023-04-13)

• Fixes to silence some clang warnings. (#2127)
• Update all rclcpp packages to C++17. (#2121)
• Use the correct macro for LifecycleNode::get_fully_qualified_name (#2117)
• add get_fully_qualified_name to rclcpp_lifecycle (#2115)
• Contributors: Chris Lalancette, Steve Macenski

19.3.0 (2023-03-01)

19.2.0 (2023-02-24)

19.1.0 (2023-02-14)

19.0.0 (2023-01-30)

18.0.0 (2022-12-29)

• Implement Unified Node Interface (NodeInterfaces class) (#2041)
• Add clock type to node_options (#1982)
• Update maintainers (#2043)
• Contributors: Audrow Nash, Jeffery Hsu, methylDragon

17.1.0 (2022-11-02)

• LifecycleNode on_configure doc fix. (#2034)
• Bugfix 20210810 get current state (#1756)
• Make lifecycle impl get_current_state() const. (#2031)
• Cleanup the lifecycle implementation (#2027)
• Cleanup the rclcpp_lifecycle dependencies. (#2021)
• Contributors: Chris Lalancette, Tomoya Fujita

17.0.0 (2022-09-13)

• Revert "Revert "Add a create_timer method to Node and [LifecycleNode]{.title-ref} classes (#1975)" (#2009) (#2010)
• Revert "Add a [create_timer]{.title-ref} method to [Node]{.title-ref} and [LifecycleNode]{.title-ref} classes (#1975)" (#2009)
• Add a [create_timer]{.title-ref} method to [Node]{.title-ref} and [LifecycleNode]{.title-ref} classes (#1975)
• Support pre-set and post-set parameter callbacks in addition to on-set-parameter-callback. (#1947)
• Make create_service accept rclcpp::QoS (#1969)
• Make create_client accept rclcpp::QoS (#1964)
• Contributors: Andrew Symington, Deepanshu Bansal, Ivan Santiago Paunovic, Shane Loretz

16.2.0 (2022-05-03)

16.1.0 (2022-04-29)

16.0.1 (2022-04-13)

16.0.0 (2022-04-08)

• remove things that were deprecated during galactic (#1913)
• Contributors: William Woodall

15.4.0 (2022-04-05)

15.3.0 (2022-03-30)

15.2.0 (2022-03-24)

• Fix rosdoc2 issues (#1897)
• Contributors: Chris Lalancette

15.1.0 (2022-03-01)

• Install headers to include/${PROJECT_NAME} (#1888)
• LifecycleNode::on_deactivate deactivate all managed entities. (#1885)
• Contributors: Shane Loretz, Tomoya Fujita

15.0.0 (2022-01-14)

• Automatically transition lifecycle entities when node transitions (#1863)
• Contributors: Ivan Santiago Paunovic

14.1.0 (2022-01-05)

14.0.0 (2021-12-17)

• Remove author by request (#1818)
• Update maintainers (#1817)
• Suppress clang dead-store warnings in the benchmarks. (#1802)
• Contributors: Chris Lalancette, Jacob Perron

13.1.0 (2021-10-18)

• Update forward declarations of [rcl_lifecycle]{.title-ref} types (#1788)
• Deprecate the [void shared_ptr<MessageT>]{.title-ref} subscription callback signatures (#1713)
• Contributors: Abrar Rahman Protyasha, Michel Hidalgo

13.0.0 (2021-08-23)

• Update client API to be able to remove pending requests. (#1734)
• Change log level for lifecycle_publisher. (#1715)
• Fix: RCLCPP_PUBLIC -> RCLCPP_LIFECYCLE_PUBLIC (#1732)
• Use rcpputils/scope_exit.hpp and remove rclcpp/scope_exit.hpp (#1727)
• Contributors: Alberto Soragna, Christophe Bedard, Ivan Santiago Paunovic, Shane Loretz

12.0.0 (2021-07-26)

• Remove unsafe get_callback_groups API. Callers should change to using for_each_callback_group(), or store the callback groups they need internally.
• Add in callback_groups_for_each. The main reason to add this method in is to make accesses to the callback_groups_ vector thread-safe. By having a callback_groups_for_each that accepts a std::function, we can just have the callers give us the callback they are interested in, and we can take care of the locking. The rest of this fairly large PR is cleaning up all of the places that use get_callback_groups() to instead use callback_groups_for_each().
• Contributors: Chris Lalancette

11.2.0 (2021-07-21)

11.1.0 (2021-07-13)

11.0.0 (2021-05-18)

• Fix destruction order in lifecycle benchmark (#1675)
• Contributors: Scott K Logan

10.0.0 (2021-05-11)

• [rclcpp] Type Adaptation feature (#1557)
• Contributors: Audrow Nash, William Woodall

9.0.2 (2021-04-14)

9.0.1 (2021-04-12)

9.0.0 (2021-04-06)

• Add generic publisher and generic subscription for serialized messages (#1452)
• updating quality declaration links (re: ros2/docs.ros2.org#52) (#1615)
• Contributors: Nikolai Morin, shonigmann

8.2.0 (2021-03-31)

• Fix flaky lifecycle node tests (#1606)
• Clock subscription callback group spins in its own thread (#1556)
• Delete debug messages (#1602)
• add automatically_add_executor_with_node option (#1594)
• Contributors: BriceRenaudeau, Ivan Santiago Paunovic, Jacob Perron, anaelle-sw

8.1.0 (2021-03-25)

8.0.0 (2021-03-23)

• make rcl_lifecyle_com_interface optional in lifecycle nodes (#1507)
• Contributors: Karsten Knese

7.0.1 (2021-03-22)

7.0.0 (2021-03-18)

• Add support for rmw_connextdds (#1574)
• Fix SEGV caused by order of destruction of Node sub-interfaces (#1469)
• Enforce static parameter types (#1522)
• Contributors: Andrea Sorbini, Colin MacKenzie, Ivan Santiago Paunovic

6.3.1 (2021-02-08)

6.3.0 (2021-01-25)

6.2.0 (2021-01-08)

6.1.0 (2020-12-10)

• add LifecycleNode::get_transition_graph to match services. (#1472)
• Update QDs to QL 1 (#1477)
• Benchmark lifecycle features (#1462)
• Contributors: Stephen Brawner, brawner, tomoya

6.0.0 (2020-11-18)

• Reserve vector capacities and use emplace_back for constructing vectors (#1464)
• [rclcpp_lifecycle] Change uint8_t iterator variables to size_t (#1461)
• Bump rclcpp packages to Quality Level 2 (#1445)
• Contributors: Louise Poubel, brawner

5.1.0 (2020-11-02)

• Increase test timeouts of slow running tests with rmw_connext_cpp (#1400)
• Update maintainers (#1384)
• Add clock qos to node options (#1375)
• Contributors: Ivan Santiago Paunovic, brawner

5.0.0 (2020-09-18)

• Increase test coverage of rclcpp_lifecycle to 96% (#1298)
• Log error instead of throwing exception in Transition and State reset(), mark no except (#1297)
• Remove unused private function (rclcpp::Node and rclcpp_lifecycle::Node) (#1294)
• Remove rmw-dependent unit-test checks (#1293)
• Added missing tests for rclcpp lifecycle (#1240)
• Warn about unused result of add_on_set_parameters_callback (#1238)
• Contributors: Alejandro Hernández Cordero, Jacob Perron, Stephen Brawner

4.0.0 (2020-07-09)

• Remove deprecated set_on_parameters_set_callback function (#1199)
• Bump to QD to level 3 and fixed links (#1158)
• Fix race in test_lifecycle_service_client (#1204)
• Contributors: Alejandro Hernández Cordero, Claire Wang, Dirk Thomas

3.0.0 (2020-06-18)

• Fix doxygen warnings (#1163)
• Contributors: Alejandro Hernández Cordero

2.0.0 (2020-06-01)

• Added missing virtual destructors. (#1149)
• Add Security Vulnerability Policy pointing to REP-2006. (#1130)
• Fixed test_lifecycle_node.cpp:check_parameters (#1136)
• Contributors: Chris Lalancette, Ivan Santiago Paunovic

1.1.0 (2020-05-26)

• Deprecate set_on_parameters_set_callback (#1123)
• Add missing parameter callback functions to lifecycle node (#1134)
• Expose get_service_names_and_types_by_node from rcl in rclcpp (#1131)
• Improve documentation (#1106)
• Fixed rep links and added more details to dependencies in quality declaration (#1116)
• Update quality declaration to reflect version 1.0 (#1115)
• Contributors: Alejandro Hernández Cordero, Claire Wang, Dirk Thomas, Stephen Brawner

1.0.0 (2020-05-12)

• Avoid callback_group deprecation (#1108)
• Contributors: Karsten Knese

0.9.1 (2020-05-08)

• Added rclcpp lifecycle Doxyfile (#1089)
• Added Quality declaration: rclcpp, rclpp_action, rclcpp_components andrclcpp_lifecycle (#1100)
• Increasing test coverage of rclcpp_lifecycle (#1045)
• Contributors: Alejandro Hernández Cordero, brawner

0.9.0 (2020-04-29)

• Export targets in addition to include directories / libraries (#1096)
• Deprecate redundant namespaces (#1083)
• Integrate topic statistics (#1072)
• Reflect changes in rclcpp API (#1079)
• Fix unknown macro errors reported by cppcheck 1.90 (#1000)
• Rremoved rmw_implementation from package.xml (#991)
• Implement functions to get publisher and subcription informations like QoS policies from topic name (#960)
• Create node clock calls const (#922)
• Type conversions fixes (#901)
• Contributors: Alejandro Hernández Cordero, Barry Xu, Devin Bonnie, Dirk Thomas, Jacob Perron, Monika Idzik, Prajakta Gokhale, Steven Macenski, William Woodall

0.8.3 (2019-11-19)

0.8.2 (2019-11-18)

0.8.1 (2019-10-23)

• New Intra-Process Communication (#778)
• Contributors: Alberto Soragna

0.8.0 (2019-09-26)

• clean up publisher and subscription creation logic (#867)
• reset error message before setting a new one, embed the original one (#854)
• remove features and related code which were deprecated in dashing (#852)
• Fix typo in deprecated warning. (#848)
• Add line break after first open paren in multiline function call (#785)
• Fixe error messages not printing to terminal (#777)
• Add default value to options in LifecycleNode construnctor. Update API documentation. (#775)
• Contributors: Dan Rose, Dirk Thomas, Esteve Fernandez, Luca Della Vedova, William Woodall, Yathartha Tuladhar

0.7.5 (2019-05-30)

0.7.4 (2019-05-29)

• Rename parameter options (#745)
• Contributors: William Woodall

0.7.3 (2019-05-20)

• Added missing template functionality to lifecycle_node. (#707)
• Contributors: Michael Jeronimo

0.7.2 (2019-05-08)

• Added new way to specify QoS settings for publishers and subscriptions. (#713)
• Deprecated shared_ptr and raw pointer versions of Publisher<T>::publish(). (#709)
• Implemented API to set callbacks for liveliness and deadline QoS events for publishers and subscriptions. (#695)
• Changed the IntraProcessManager to be capable of storing shared_ptr<const T> in addition to unique_ptr<T>. (#690)
• Contributors: M. M, William Woodall, ivanpauno

0.7.1 (2019-04-26)

• Added read only parameters. (#495)
• Contributors: Shane Loretz, William Woodall

0.7.0 (2019-04-14)

• Fixed linter errors in rclcpp_lifecycle. (#672)
• Added parameter-related templates to LifecycleNode. (#645)
• Fixed use_sim_time issue on LifeCycleNode. (#651)
• Updated to use ament_target_dependencies where possible. (#659)
• Fixed hard-coded duration type representation so int64_t isn't assumed. (#648)
• Added a method to the LifecycleNode class to get the logging interface. (#652)
• Set Parameter Event Publisher settings #591 (#614)
• Replaced node constructor arguments with NodeOptions. (#622)
• Removed dependency on rclpy. (#626)
• Contributors: Emerson Knapp, Karsten Knese, Michael Carroll, Michael Jeronimo, Vinnam Kim, William Woodall, ivanpauno, rarvolt

0.6.2 (2018-12-13)

0.6.1 (2018-12-07)

• Added node path and time stamp to parameter event message (#584)
• Refactored init to allow for non-global init (#587)
• Add class Waitable (#589)
• Contributors: Dirk Thomas, Jacob Perron, William Woodall, bpwilcox

0.6.0 (2018-11-19)

• Updated to use new error handling API from rcutils (#577)
• Deleted TRANSITION_SHUTDOWN (#576)
• Added a warning when publishing if publisher is not active (#574)
• Added SMART_PTRS_DEF to LifecyclePublisher (#569)
• Added service for transition graph (#555)
• Added semicolons to all RCLCPP and RCUTILS macros. (#565)
• Fixed and improved documentation (#546)
• Removed unneeded dependency on std_msgs (#513)
• Removed use of uninitialized CMake var (#511)
• Added get_node_names API from node. (#508)
• Fixed rosidl dependencies (#507)
• Contributors: Chris Lalancette, Dirk Thomas, Francisco Martín Rico, Karsten Knese, Mikael Arguedas, Sriram Raghunathan, William Woodall, cho3

0.5.0 (2018-06-25)

• Added functions that allow you to publish serialized messages and received serialized messages in your subscription callback. (#388)
• Added ability to initialize parameter values in a node with an argument to the Node constructor. (#486)
• Nodes now autostart the ROS parameter services which let you get, set, and list parameters in a node. (#478)
• Fixed a bug that occurred when mixing std::shared_ptr and std::bind. (#470)
• Added ability to pass command line arguments to the Node constructor. (#461)
• Changed library export order for static linking. (#446)
• Now depends on ament_cmake_ros. (#444)
• Updaed code to use logging macros rather than fprintf(). (#439)
• Contributors: Dirk Thomas, Guillaume Autran, Karsten Knese, Michael Carroll, Mikael Arguedas, Shane Loretz, dhood