Skip to content

Fix pluginlib_enable_plugin_testing() docstring pitfalls. - #305

Merged
ahcorde merged 1 commit into
rollingfrom
clalancette/fix-plugin-testing-docs
Aug 20, 2026
Merged

Fix pluginlib_enable_plugin_testing() docstring pitfalls.#305
ahcorde merged 1 commit into
rollingfrom
clalancette/fix-plugin-testing-docs

Conversation

@clalancette

Copy link
Copy Markdown
Contributor

The usage example wrapped the APPEND_ENV value in double quotes. CMake passes those quotes through as literal characters in the environment variable value, so tests copying the example end up with a mock install path that is never found at test time. Fix the example and call the pitfall out explicitly.

Also document that keeping the default PACKAGE_NAME shadows the real package when it is installed in a prefix which comes earlier in AMENT_PREFIX_PATH (as is the case when a package's own tests run against its install space), in which case pluginlib fails to find the plugin library in the mock install.

Also see ros2/urdf#57 , which is where this was found.

I used Claude Fable 5 while creating this change.

The usage example wrapped the APPEND_ENV value in double quotes.  CMake
passes those quotes through as literal characters in the environment
variable value, so tests copying the example end up with a mock install
path that is never found at test time.  Fix the example and call the
pitfall out explicitly.

Also document that keeping the default PACKAGE_NAME shadows the real
package when it is installed in a prefix which comes earlier in
AMENT_PREFIX_PATH (as is the case when a package's own tests run
against its install space), in which case pluginlib fails to find the
plugin library in the mock install.

Signed-off-by: Chris Lalancette <clalancette@gmail.com>
@mergify

mergify Bot commented Aug 5, 2026

Copy link
Copy Markdown

Tick the box to add this pull request to the merge queue (same as @mergifyio queue).

  • Queue this pull request

@clalancette

clalancette commented Aug 10, 2026

Copy link
Copy Markdown
Contributor Author

CI:

  • Linux Build Status
  • Linux-aarch64 Build Status
  • Linux-rhel Build Status
  • Windows Build Status

@ahcorde
ahcorde merged commit b4fe247 into rolling Aug 20, 2026
3 checks passed
@ahcorde
ahcorde deleted the clalancette/fix-plugin-testing-docs branch August 20, 2026 08:32
@ahcorde

ahcorde commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

https://github.com/Mergifyio backport lyrical kilted jazzy humble

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants