This YAML file can be used to declare specific information to be used inside the recipe. This file is specific to each recipe conanfile.py and it should be placed next to it. The file is automatically exported with the recipe (no need to add it to exports attribute) and its content is loaded into the conan_data attribute of the recipe.
This file can be used, for example, to declare a list of sources links and checksums for the recipe or a list patches to apply to them, but you can use it to store any data you want to extract from the recipe. For example:
sources: "1.70.0": url: "https://boostorg.jfrog.io/artifactory/main/release/1.70.0/source/boost_1_70_0.tar.bz2" sha256: "430ae8354789de4fd19ee52f3b1f739e1fba576f0aded0897c3c2bc00fb38778" "1.71.0": url: "https://boostorg.jfrog.io/artifactory/main/release/1.70.0/source/boost_1_71_0.tar.bz2" sha256: "d73a8da01e8bf8c7eda40b4c84915071a8c8a0df4a6734537ddde4a8580524ee" patches: "1.70.0": patches: "0001-beast-fix-moved-from-executor.patch,bcp_namespace_issues.patch" "1.71.0": patches: "bcp_namespace_issues.patch,boost_build_qcc_fix_debug_build_parameter.patch" requirements: - "foo/1.0" - "bar/1.0"
Usages in a conanfile.py:
def source(self): tools.get(**self.conan_data["sources"][self.version]) for patch in self.conan_data["patches"][self.version]: tools.patch(**patch) def requirements(self): for req in self.conan_data["requirements"]: self.requires(req)
Use always quotes around versions numbers, otherwise YAML parser could interpret those values as integers or floats and lead to unexpected effects when comparing them against the recipe version inside the recipes.
The first level entry key
.conan is reserved for Conan usage.