conan search
$ conan search [-h] [-o] [-q QUERY] [-r REMOTE] [--case-sensitive]
[--raw] [--table TABLE]
[pattern_or_reference]
Searches package recipes and binaries in the local cache or in a remote. If you provide a pattern, then it will search for existing package recipes matching it. If a full reference is provided (pkg/0.1@user/channel) then the existing binary packages for that reference will be displayed. If no remote is specified, the serach will be done in the local cache. Search is case sensitive, exact case has to be used. For case insensitive file systems, like Windows, case sensitive search can be forced with ‘–case-sensitive’.
positional arguments:
pattern_or_reference Pattern or package recipe reference, e.g., 'boost/*',
'MyPackage/1.2@user/channel'
optional arguments:
-h, --help show this help message and exit
-o, --outdated Show only outdated from recipe packages
-q QUERY, --query QUERY
Packages query: 'os=Windows AND (arch=x86 OR
compiler=gcc)'. The 'pattern_or_reference' parameter
has to be a reference: MyPackage/1.2@user/channel
-r REMOTE, --remote REMOTE
Remote to search in. '-r all' searches all remotes
--case-sensitive Make a case-sensitive search. Use it to guarantee
case-sensitive search in Windows or other case-
insensitive file systems
--raw Print just the list of recipes
--table TABLE Outputs html file with a table of binaries. Only valid
for a reference search
Examples
$ conan search zlib/*
$ conan search zlib/* -r=conan-center
To search for recipes in all defined remotes use --all
(this is only valid for searching recipes, not binaries):
$ conan search zlib/* -r=all
If you use instead the full package recipe reference, you can explore the binaries existing for that recipe, also in a remote or in the local conan cache:
$ conan search Boost/1.60.0@lasote/stable
A query syntax is allowed to look for specific binaries, you can use AND
and OR
operators
and parenthesis, with settings and also options.
$ conan search Boost/1.60.0@lasote/stable -q arch=x86_64
$ conan search Boost/1.60.0@lasote/stable -q "(arch=x86_64 OR arch=ARM) AND (build_type=Release OR os=Windows)"
If you specify a query filter for a setting and the package recipe is not restricted by this setting, will find all packages:
class MyRecipe(ConanFile):
settings="arch"
$ conan search MyRecipe/1.0@lasote/stable -q os=Windows
The query above will find all the MyRecipe
binary packages, because the recipe doesn’t declare
“os” as a setting.
You can generate a table for all binaries from a given recipe with the --table
option:
$ conan search zlib/1.2.11@conan/stable --table=file.html -r=conan-center
$ file.html # or open the file, double-click