Skip to content

Fix pluginlib_enable_plugin_testing() docstring pitfalls. - #305

Open
clalancette wants to merge 1 commit into
rollingfrom
clalancette/fix-plugin-testing-docs
Open

Fix pluginlib_enable_plugin_testing() docstring pitfalls.#305
clalancette wants to merge 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

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.

1 participant