feature request: list all (namespaced / imported / aliased) targets added by FetchContent

Development
1

problem:
when adding a new library (with FetchContent_Declare & MakeAvailable) I have no idea what targets are available. I can google / stackoverflow and hope someone has documented, but it’s not a good experience. I can also spelunk in the lib-config.cmake file. Or I can guess and hope the targets are sensibly named. cmake docs recommend “Check the documentation for the package or Find module to see what imported targets it defines, if any.” which doesn’t seem good enough to me!

solution:
there should be a way to list the (namespaced) targets added by a FetchContent_Declare & MakeAvailable.

(bad) workarounds:

  1. use a recursive subdirectory function, and print all BUILDSYSTEM_TARGETS. problems: this only prints e.g. boost_algorithm, etc not Boost::Algorithm (namespaced targets are the preferred way to include “If the dependency provides namespaced targets of the form SomePrefix::ThingName, the project should link to those rather than to any non-namespaced targets.”)
graph=$(mktemp)
cmake --graphviz=$graph builddir
rg --only-matching --no-line-number "\w*::\w*" $graph | sort -u

this will print out all namespaced targets, but it is clearly not a good solution. however it does indicate that cmake internally has this information, but just doesn’t expose it neatly.

2

an extension to this feature request would implement something like cmake add-dependency https://github.com/jeremy-rifkin/libassert, which would be a nicer experience than current, and comparable to cargo add among others.

I’m currently doing this with a (bad, flaky) bash script:

#!/bin/sh

set -eu

repo="$1/$2"
repo_org="$1"
repo_name="$2"

tag=$(
    curl --silent -m 10 --connect-timeout 5 "https://api.github.com/repos/$repo/releases/latest" |
    jq -r ".tag_name"
)

if (rg "FetchContent_MakeAvailable\($repo_name\)"); then
    echo "dependency $repo already found in CMakeLists.txt"
else
    template=$(mktemp)

    echo "FetchContent_Declare(
    $repo_name
    GIT_REPOSITORY https://github.com/$repo
    GIT_TAG $tag
    EXCLUDE_FROM_ALL
    SYSTEM
    OVERRIDE_FIND_PACKAGE
)
FetchContent_MakeAvailable($repo_name)
" > $template

sed -i "/include(FetchContent)/r $template" CMakeLists.txt
fi

graph=$(mktemp)
cmake --graphviz=$graph build
rg --only-matching --no-line-number "\w*::\w*" $graph | sort -u