Add cleanup_controller lifecycle transition

[soham2560]

Brief

This PR completes #1236 by @bailaC which was started to fix #759.

TODOs

• Address previous discussions on original PR
  • Port over suggestions from original PR refer 3b5f695
  • Change only service name to unconfigure_controller as discussed with @saikishor and @bmagyar refer 0e86448
  • Add documentation refer bf7418c

[codecov]

Codecov Report

❌ Patch coverage is 91.35802% with 7 lines in your changes missing coverage. Please review.
✅ Project coverage is 89.44%. Comparing base (16cabad) to head (87119de).

Files with missing lines	Patch %	Lines
controller_manager/src/controller_manager.cpp	84.00%	1 Missing and 3 partials ⚠️
.../controller_manager/controller_manager_services.py	25.00%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #2414      +/-   ##
==========================================
+ Coverage   89.41%   89.44%   +0.02%     
==========================================
  Files         155      156       +1     
  Lines       18144    18223      +79     
  Branches     1478     1482       +4     
==========================================
+ Hits        16223    16299      +76     
- Misses       1329     1330       +1     
- Partials      592      594       +2     

Flag	Coverage Δ
unittests	89.44% <91.35%> (+0.02%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
controller_manager/controller_manager/__init__.py	100.00% <ø> (ø)
.../include/controller_manager/controller_manager.hpp	97.29% <ø> (ø)
...ontroller_manager/test/test_cleanup_controller.cpp	100.00% <100.00%> (ø)
...ller_manager/test/test_controller_manager_srvs.cpp	99.42% <100.00%> (+0.01%)	⬆️
.../controller_manager/controller_manager_services.py	79.88% <25.00%> (-1.26%)	⬇️
controller_manager/src/controller_manager.cpp	77.41% <84.00%> (+0.25%)	⬆️

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[saikishor]

Just some minor nitpicks

[soham2560]

@saikishor have addressed your comments let me know what you think

[christophfroehlich]

LGTM, but could we add release notes for this please? And we should create a follow-up issue to patch rqt_controller_manager with the new transition.
Also this has to be udpated (in a future PR maybe)

ros2_control/ros2controlcli/ros2controlcli/verb/set_controller_state.py

Line 33 in eba8665

# choices=['unconfigured', 'inactive', 'active'], TODO(destogl): when cleanup is impl

ros2_control/ros2controlcli/ros2controlcli/verb/set_controller_state.py

Lines 48 to 59 in eba8665

	# TODO(destogl): This has to be implemented in CLI and controller manager
	# if args.state == 'unconfigured':
	# if matched_controller.state != 'inactive':
	# return f'cannot cleanup {matched_controller.name} ' \
	# f'from its current state {matched_controller.state}'
	# response = cleanup_controller(
	# node, args.controller_manager, args.controller_name
	# )
	# if not response.ok:
	# return 'Error cleaning up controller, check controller_manager logs'
	# # print(f'successfully cleaned up {args.controller_name}')
	# return 0

[christophfroehlich]

Suggested change

	// find and clean controller if it is inactive
	// call cleanup transition, if it is inactive

[christophfroehlich]

Friendly ping @soham2560 :)

[soham2560]

Yes! we should do that

sorry for the delay, been busy with work, this week will be hectic as well, I would be happy to address it after that, hope that is fine

@christophfroehlich