Search output

Warning

This is an experimental feature subject to breaking changes in future releases.

The conan search provides a --json parameter to generate a file containing the information of the search process.

The output JSON contains a two first level keys:

  • error: True if the upload completed without error, False otherwise.

  • results: A list of the remotes with the packages found. Each element contains:

    • remote: Name of the remote.

    • items: List of the items found in that remote. For each item there will always be a

      recipe and optionally also packages when searching them.

      • recipe: Document representing the uploaded recipe.
        • id: Reference, e.g., “openssl/1.0.2u”

      • packages: List of elements representing the binary packages found for the recipe.
        • id: Package ID, e.g., “8018a4df6e7d2b4630a814fa40c81b85b9182d2b”

        • options: Dictionary of options of the package.

        • settings: Dictionary with settings of the package.

        • requires: List of requires of the package.

        • outdated: Boolean to show whether package is outdated from recipe or not.

Examples:

  • Search references in all remotes: conan search eigen* -r all

    {
        "error": false,
        "results": [{
            "remote": "conan-center",
            "items": [{
                "recipe": {
                    "id": "eigen/3.3.4@conan/stable"
                }
            }, {
                "recipe": {
                    "id": "eigen/3.3.5@conan/stable"
                }
            }, {
                "recipe": {
                    "id": "eigen/3.3.7"
                }
            }, {
                "recipe": {
                    "id": "eigen/3.3.7@conan/stable"
                }
            }]
        }, {
            "remote": "otherremote",
            "items": [{
                "recipe": {
                    "id": "eigen/3.3.4@conan/stable"
                }
            }, {
                "recipe": {
                    "id": "eigen/3.3.5@conan/stable"
                }
            }, {
                "recipe": {
                    "id": "eigen/3.3.7@conan/stable"
                }
            }]
        }]
    }
    
  • Search packages of a reference in a remote: conan search paho-c/1.2.0@conan/stable -r conan-center --json search.json

    {
        "error":false,
        "results":[
            {
                "remote":"conan-center",
                "items":[
                    {
                        "recipe":{
                            "id":"paho-c/1.2.0@conan/stable"
                        },
                        "packages":[
                            {
                                "id":"0000193ac313953e78a4f8e82528100030ca70ee",
                                "options":{
                                    "shared":"False",
                                    "asynchronous":"False",
                                    "SSL":"False"
                                },
                                "settings":{
                                    "os":"Linux",
                                    "arch":"x86_64",
                                    "compiler":"gcc",
                                    "build_type":"Debug",
                                    "compiler.version":"4.9"
                                },
                                "requires":[
    
                                ],
                                "outdated":false
                            },
                            {
                                "id":"014be746b283391f79d11e4e8af3154344b58223",
                                "options":{
                                    "shared":"False",
                                    "asynchronous":"False",
                                    "SSL":"False"
                                },
                                "settings":{
                                    "os":"Windows",
                                    "compiler.threads":"posix",
                                    "compiler.exception":"seh",
                                    "arch":"x86_64",
                                    "compiler":"gcc",
                                    "build_type":"Debug",
                                    "compiler.version":"5"
                                },
                                "requires":[
    
                                ],
                                "outdated":false
                            },
                            {
                              "id":"0188020dbfd167611b967ad2fa0e30710d23e920",
                                "options":{
                                    "shared":"True",
                                    "asynchronous":"False",
                                    "SSL":"False"
                                },
                                "settings":{
                                    "os":"Macos",
                                    "arch":"x86_64",
                                    "compiler":"apple-clang",
                                    "build_type":"Debug",
                                    "compiler.version":"9.1"
                                },
                                "requires":[
    
                                ],
                                "outdated":false
                            },
                            {
                                "id":"03369b0caf8c0c8d4bb84d5136112596bde4652d",
                                "options":{
                                    "shared":"True",
                                    "asynchronous":"False",
                                    "SSL":"False"
                                },
                                "settings":{
                                    "os":"Linux",
                                    "arch":"x86",
                                    "compiler":"gcc",
                                    "build_type":"Release",
                                    "compiler.version":"5"
                                },
                                "requires":[
    
                                ],
                                "outdated":false
                            }
                        ]
                    }
                ]
            }
        ]
    }
    
  • Search references in local cache: conan search paho-c* --json search.json

    {
        "error":false,
        "results":[
            {
                "remote":"None",
                "items":[
                    {
                        "recipe":{
                            "id":"paho-c/1.2.0@danimtb/testing"
                        }
                    }
                ]
            }
        ]
    }
    
  • Search packages of a reference in local cache: conan search paho-c/1.2.0@danimtb/testing --json search.json

    {
        "error":false,
        "results":[
            {
                "remote":"None",
                "items":[
                    {
                        "recipe":{
                            "id":"paho-c/1.2.0@danimtb/testing"
                        },
                          "packages":[
                            {
                                "id":"6cc50b139b9c3d27b3e9042d5f5372d327b3a9f7",
                                "options":{
                                    "SSL":"False",
                                    "asynchronous":"False",
                                    "shared":"False"
                                },
                                "settings":{
                                    "arch":"x86_64",
                                    "build_type":"Release",
                                    "compiler":"Visual Studio",
                                    "compiler.runtime":"MD",
                                    "compiler.version":"15",
                                    "os":"Windows"
                                },
                                "requires":[
    
                                ],
                                "outdated":false
                              },
                              {
                                "id":"95cd13dfc3f6b80d3ccb2a38441e3a1ad88e5a15",
                                "options":{
                                    "SSL":"False",
                                    "asynchronous":"True",
                                    "shared":"True"
                                },
                                "settings":{
                                    "arch":"x86_64",
                                    "build_type":"Release",
                                    "compiler":"Visual Studio",
                                    "compiler.runtime":"MD",
                                    "compiler.version":"15",
                                    "os":"Windows"
                                },
                                "requires":[
    
                                ],
                                "outdated":true
                            },
                            {
                                "id":"970e773c5651dc2560f86200a4ea56c23f568ff9",
                                "options":{
                                    "SSL":"False",
                                    "asynchronous":"False",
                                    "shared":"True"
                                },
                                "settings":{
                                    "arch":"x86_64",
                                    "build_type":"Release",
                                    "compiler":"Visual Studio",
                                    "compiler.runtime":"MD",
                                    "compiler.version":"15",
                                    "os":"Windows"
                                },
                                "requires":[
    
                                ],
                                "outdated":true
                            },
                            {
                                "id":"c4c0a49b09575515ce1dd9841a48de0c508b9d7c",
                                "options":{
                                    "SSL":"True",
                                    "asynchronous":"False",
                                    "shared":"True"
                                },
                                "settings":{
                                    "arch":"x86_64",
                                    "build_type":"Release",
                                    "compiler":"Visual Studio",
                                    "compiler.runtime":"MD",
                                    "compiler.version":"15",
                                    "os":"Windows"
                                },
                                "requires":[
                                    "openssl/1.0.2n@conan/stable:606fdb601e335c2001bdf31d478826b644747077",
                                    "zlib/1.2.11@conan/stable:6cc50b139b9c3d27b3e9042d5f5372d327b3a9f7"
                                ],
                                "outdated":true
                            },
                            {
                                "id":"db9d6ba7004592ed2598f2c369484d4a01269110",
                                "options":{
                                    "SSL":"True",
                                    "asynchronous":"False",
                                    "shared":"True"
                                },
                                "settings":{
                                    "arch":"x86_64",
                                    "build_type":"Release",
                                    "compiler":"gcc",
                                    "compiler.exception":"seh",
                                    "compiler.threads":"posix",
                                    "compiler.version":"7",
                                    "os":"Windows"
                                },
                                "requires":[
                                    "openssl/1.0.2n@conan/stable:f761d91cef7988eafb88c6b6179f4cf261609f26",
                                    "zlib/1.2.11@conan/stable:6dc82da13f94df549e60f9c1ce4c5d11285a4dff"
                                ],
                                "outdated":true
                            }
                        ]
                    }
                ]
            }
        ]
    }