From 94c265113326de5aa54ba49f5289f4cf55fecb4f Mon Sep 17 00:00:00 2001 From: ConanCI bot Date: Tue, 14 Nov 2023 14:13:05 +0000 Subject: [PATCH] Automatic deploy (build number 568) --- 2.0/.buildinfo | 2 +- 2.0/404.html | 14 +- 2.0/Page Not Found.html | 14 +- 2.0/_sources/changelog.rst.txt | 42 + 2.0/_sources/devops.rst.txt | 1 + .../backup_sources/sources_backup.rst.txt | 2 + 2.0/_sources/devops/metadata.rst.txt | 28 +- 2.0/_sources/devops/save_restore.rst.txt | 59 + 2.0/_sources/reference/commands/build.rst.txt | 78 +- 2.0/_sources/reference/commands/cache.rst.txt | 81 ++ .../reference/commands/create.rst.txt | 73 +- .../commands/graph/build_order.rst.txt | 184 ++- .../reference/commands/graph/info.rst.txt | 261 +++-- .../reference/commands/install.rst.txt | 74 +- 2.0/_sources/reference/commands/list.rst.txt | 35 +- .../reference/commands/lock/create.rst.txt | 143 +-- .../reference/commands/profile.rst.txt | 93 +- .../reference/commands/remove.rst.txt | 7 +- 2.0/_sources/reference/commands/test.rst.txt | 82 +- .../reference/conanfile/attributes.rst.txt | 6 + .../conanfile/methods/source.rst.txt | 2 + .../reference/config_files/settings.rst.txt | 2 +- 2.0/_sources/reference/tools.rst.txt | 35 +- .../reference/tools/cmake/cmakedeps.rst.txt | 1 + .../tools/cmake/cmaketoolchain.rst.txt | 16 + .../tools/gnu/autotoolstoolchain.rst.txt | 11 +- .../reference/tools/gnu/pkgconfigdeps.rst.txt | 5 +- 2.0/_sources/reference/tools/google.rst.txt | 11 + .../reference/tools/google/bazel.rst.txt | 51 + .../reference/tools/google/bazeldeps.rst.txt | 268 +++++ .../tools/google/bazeltoolchain.rst.txt | 78 ++ .../tools/system/package_manager.rst.txt | 4 +- 2.0/_sources/tutorial/other_features.rst.txt | 41 + .../versioning/version_ranges.rst.txt | 10 +- 2.0/_static/documentation_options.js | 2 +- 2.0/changelog.html | 80 +- 2.0/conan.pdf | Bin 3847390 -> 3892331 bytes 2.0/devops.html | 16 +- .../creating_backup_sources_repo.html | 15 +- 2.0/devops/backup_sources/sources_backup.html | 16 +- 2.0/devops/conancenter/hosting_binaries.html | 15 +- 2.0/devops/metadata.html | 27 +- 2.0/devops/save_restore.html | 753 ++++++++++++ 2.0/devops/using_conancenter.html | 15 +- 2.0/devops/versioning.html | 15 +- .../versioning/resolve_prereleases.html | 19 +- 2.0/examples.html | 14 +- 2.0/examples/commands.html | 14 +- 2.0/examples/commands/pkglists.html | 14 +- 2.0/examples/conanfile.html | 14 +- 2.0/examples/conanfile/layout.html | 14 +- .../layout/conanfile_in_subfolder.html | 14 +- .../conanfile/layout/editable_components.html | 14 +- .../layout/multiple_subprojects.html | 14 +- .../layout/third_party_libraries.html | 14 +- 2.0/examples/conanfile/package_info.html | 14 +- .../conanfile/package_info/components.html | 14 +- .../package_info_conf_and_env.html | 14 +- 2.0/examples/config_files.html | 14 +- .../config_files/settings/settings_user.html | 14 +- 2.0/examples/cross_build.html | 14 +- .../cross_build/android/android_studio.html | 14 +- 2.0/examples/cross_build/android/ndk.html | 14 +- 2.0/examples/dev_flow.html | 14 +- .../debug/step_into_dependencies.html | 14 +- 2.0/examples/extensions.html | 14 +- .../clean/custom_command_clean_revisions.html | 14 +- .../extensions/commands/custom_commands.html | 14 +- .../deployers/builtin_deployers.html | 14 +- .../deployers/custom_deployers.html | 14 +- .../deployers/dev/development_deploy.html | 14 +- .../sources/custom_deployer_sources.html | 14 +- 2.0/examples/graph.html | 14 +- .../graph/requires/consume_cmake_macro.html | 14 +- .../tool_requires/different_options.html | 14 +- .../tool_requires/different_versions.html | 14 +- .../tool_requires/use_cmake_modules.html | 14 +- .../graph/tool_requires/using_protobuf.html | 14 +- 2.0/examples/tools.html | 14 +- 2.0/examples/tools/autotools/autotools.html | 14 +- .../build_project_autotools_toolchain.html | 14 +- 2.0/examples/tools/cmake/cmake.html | 14 +- .../build_project_cmake_presets.html | 14 +- .../extend_own_cmake_presets.html | 14 +- .../inject_cmake_variables.html | 14 +- 2.0/examples/tools/files/files.html | 14 +- .../tools/files/patches/patch_sources.html | 14 +- 2.0/examples/tools/meson/meson.html | 14 +- .../build_simple_meson_project.html | 14 +- .../scm/git/capture_scm/git_capture_scm.html | 14 +- 2.0/genindex.html | 68 +- 2.0/index.html | 15 +- 2.0/installation.html | 14 +- 2.0/integrations.html | 18 +- 2.0/integrations/android.html | 14 +- 2.0/integrations/autotools.html | 14 +- 2.0/integrations/clion.html | 14 +- 2.0/integrations/cmake.html | 14 +- 2.0/integrations/jfrog.html | 14 +- 2.0/integrations/makefile.html | 14 +- 2.0/integrations/meson.html | 14 +- 2.0/integrations/visual_studio.html | 14 +- 2.0/integrations/xcode.html | 14 +- 2.0/introduction.html | 14 +- 2.0/knowledge.html | 14 +- 2.0/knowledge/cheatsheet.html | 14 +- 2.0/knowledge/faq.html | 14 +- 2.0/knowledge/guidelines.html | 14 +- 2.0/knowledge/videos.html | 14 +- 2.0/objects.inv | Bin 13426 -> 13797 bytes 2.0/reference.html | 31 +- 2.0/reference/binary_model.html | 14 +- .../binary_model/custom_compatibility.html | 14 +- 2.0/reference/binary_model/dependencies.html | 14 +- 2.0/reference/binary_model/extending.html | 14 +- 2.0/reference/binary_model/package_id.html | 14 +- 2.0/reference/commands.html | 14 +- 2.0/reference/commands/build.html | 92 +- 2.0/reference/commands/cache.html | 84 +- 2.0/reference/commands/config.html | 14 +- 2.0/reference/commands/create.html | 87 +- 2.0/reference/commands/download.html | 14 +- 2.0/reference/commands/editable.html | 14 +- 2.0/reference/commands/export-pkg.html | 14 +- 2.0/reference/commands/export.html | 14 +- .../formatters/graph_info_json_formatter.html | 14 +- 2.0/reference/commands/graph.html | 14 +- 2.0/reference/commands/graph/build_order.html | 198 +++- .../commands/graph/build_order_merge.html | 14 +- 2.0/reference/commands/graph/info.html | 91 +- 2.0/reference/commands/inspect.html | 14 +- 2.0/reference/commands/install.html | 88 +- 2.0/reference/commands/list.html | 44 +- 2.0/reference/commands/lock.html | 14 +- 2.0/reference/commands/lock/add.html | 14 +- 2.0/reference/commands/lock/create.html | 157 +-- 2.0/reference/commands/lock/merge.html | 14 +- 2.0/reference/commands/new.html | 14 +- 2.0/reference/commands/profile.html | 107 +- 2.0/reference/commands/remote.html | 14 +- 2.0/reference/commands/remove.html | 21 +- 2.0/reference/commands/search.html | 14 +- 2.0/reference/commands/source.html | 14 +- 2.0/reference/commands/test.html | 96 +- 2.0/reference/commands/upload.html | 14 +- 2.0/reference/commands/version.html | 14 +- 2.0/reference/conan_server.html | 14 +- 2.0/reference/conanfile.html | 14 +- 2.0/reference/conanfile/attributes.html | 50 +- 2.0/reference/conanfile/methods.html | 14 +- 2.0/reference/conanfile/methods/build.html | 14 +- 2.0/reference/conanfile/methods/build_id.html | 14 +- .../conanfile/methods/build_requirements.html | 14 +- .../conanfile/methods/compatibility.html | 14 +- .../conanfile/methods/config_options.html | 14 +- .../conanfile/methods/configure.html | 14 +- 2.0/reference/conanfile/methods/export.html | 14 +- .../conanfile/methods/export_sources.html | 14 +- 2.0/reference/conanfile/methods/generate.html | 14 +- 2.0/reference/conanfile/methods/init.html | 14 +- 2.0/reference/conanfile/methods/layout.html | 14 +- 2.0/reference/conanfile/methods/package.html | 14 +- .../conanfile/methods/package_id.html | 14 +- .../conanfile/methods/package_info.html | 14 +- .../conanfile/methods/requirements.html | 14 +- 2.0/reference/conanfile/methods/set_name.html | 14 +- .../conanfile/methods/set_version.html | 14 +- 2.0/reference/conanfile/methods/source.html | 15 +- .../methods/system_requirements.html | 14 +- 2.0/reference/conanfile/methods/test.html | 14 +- 2.0/reference/conanfile/methods/validate.html | 14 +- .../conanfile/methods/validate_build.html | 14 +- .../conanfile/running_and_output.html | 14 +- 2.0/reference/conanfile_txt.html | 14 +- 2.0/reference/config_files.html | 18 +- 2.0/reference/config_files/conanrc.html | 14 +- 2.0/reference/config_files/credentials.html | 14 +- 2.0/reference/config_files/global_conf.html | 14 +- 2.0/reference/config_files/profiles.html | 14 +- 2.0/reference/config_files/remotes.html | 14 +- 2.0/reference/config_files/settings.html | 16 +- .../config_files/source_credentials.html | 14 +- 2.0/reference/environment.html | 14 +- 2.0/reference/extensions.html | 14 +- .../extensions/binary_compatibility.html | 14 +- 2.0/reference/extensions/command_wrapper.html | 14 +- 2.0/reference/extensions/custom_commands.html | 14 +- .../extensions/custom_generators.html | 14 +- 2.0/reference/extensions/deployers.html | 14 +- 2.0/reference/extensions/hooks.html | 14 +- 2.0/reference/extensions/package_signing.html | 14 +- 2.0/reference/extensions/profile_plugin.html | 14 +- 2.0/reference/extensions/python_api.html | 14 +- .../extensions/python_api/ConanAPI.html | 14 +- .../extensions/python_api/ConfigAPI.html | 24 +- .../extensions/python_api/DownloadAPI.html | 14 +- .../extensions/python_api/ExportAPI.html | 14 +- .../extensions/python_api/GraphAPI.html | 14 +- .../extensions/python_api/InstallAPI.html | 14 +- .../extensions/python_api/ListAPI.html | 14 +- .../extensions/python_api/NewAPI.html | 14 +- .../extensions/python_api/ProfilesAPI.html | 14 +- .../extensions/python_api/RemotesAPI.html | 14 +- .../extensions/python_api/RemoveAPI.html | 14 +- .../extensions/python_api/SearchAPI.html | 14 +- .../extensions/python_api/UploadAPI.html | 14 +- 2.0/reference/extensions/python_requires.html | 14 +- 2.0/reference/tools.html | 119 +- 2.0/reference/tools/android.html | 39 +- 2.0/reference/tools/apple.html | 35 +- 2.0/reference/tools/apple/other.html | 35 +- 2.0/reference/tools/apple/xcodebuild.html | 31 +- 2.0/reference/tools/apple/xcodedeps.html | 31 +- 2.0/reference/tools/apple/xcodetoolchain.html | 31 +- 2.0/reference/tools/build.html | 39 +- 2.0/reference/tools/cmake.html | 35 +- 2.0/reference/tools/cmake/cmake.html | 34 +- 2.0/reference/tools/cmake/cmake_layout.html | 35 +- 2.0/reference/tools/cmake/cmakedeps.html | 32 +- 2.0/reference/tools/cmake/cmaketoolchain.html | 47 +- 2.0/reference/tools/cpp_info.html | 39 +- 2.0/reference/tools/env.html | 35 +- 2.0/reference/tools/env/environment.html | 31 +- 2.0/reference/tools/env/envvars.html | 31 +- 2.0/reference/tools/env/virtualbuildenv.html | 31 +- 2.0/reference/tools/env/virtualrunenv.html | 35 +- 2.0/reference/tools/files.html | 35 +- 2.0/reference/tools/files/basic.html | 31 +- 2.0/reference/tools/files/checksum.html | 31 +- 2.0/reference/tools/files/downloads.html | 31 +- 2.0/reference/tools/files/packaging.html | 35 +- 2.0/reference/tools/files/patches.html | 31 +- 2.0/reference/tools/files/symlinks.html | 31 +- 2.0/reference/tools/gnu.html | 37 +- 2.0/reference/tools/gnu/autotools.html | 33 +- 2.0/reference/tools/gnu/autotoolsdeps.html | 33 +- .../tools/gnu/autotoolstoolchain.html | 41 +- 2.0/reference/tools/gnu/makedeps.html | 33 +- 2.0/reference/tools/gnu/pkgconfig.html | 37 +- 2.0/reference/tools/gnu/pkgconfigdeps.html | 38 +- 2.0/reference/tools/google.html | 749 ++++++++++++ 2.0/reference/tools/google/bazel.html | 818 +++++++++++++ 2.0/reference/tools/google/bazeldeps.html | 1020 +++++++++++++++++ .../tools/google/bazeltoolchain.html | 888 ++++++++++++++ 2.0/reference/tools/intel.html | 39 +- 2.0/reference/tools/layout.html | 39 +- 2.0/reference/tools/meson.html | 35 +- 2.0/reference/tools/meson/meson.html | 35 +- 2.0/reference/tools/meson/mesontoolchain.html | 31 +- 2.0/reference/tools/microsoft.html | 35 +- 2.0/reference/tools/microsoft/helpers.html | 31 +- 2.0/reference/tools/microsoft/msbuild.html | 31 +- .../tools/microsoft/msbuilddeps.html | 31 +- .../tools/microsoft/msbuildtoolchain.html | 31 +- 2.0/reference/tools/microsoft/nmake.html | 31 +- 2.0/reference/tools/microsoft/vcvars.html | 31 +- .../tools/microsoft/visual_layout.html | 31 +- 2.0/reference/tools/scm.html | 31 +- 2.0/reference/tools/scm/git.html | 31 +- 2.0/reference/tools/scm/version.html | 35 +- 2.0/reference/tools/scons.html | 39 +- 2.0/reference/tools/system.html | 39 +- .../tools/system/package_manager.html | 43 +- 2.0/search.html | 14 +- 2.0/searchindex.js | 2 +- 2.0/sitemap.xml | 2 +- 2.0/tutorial.html | 15 +- 2.0/tutorial/conan_repositories.html | 14 +- .../conan_repositories/conan_center.html | 14 +- .../setting_up_conan_remotes.html | 14 +- .../artifactory/artifactory_ce_cpp.html | 14 +- .../conan_server.html | 14 +- .../uploading_packages.html | 14 +- 2.0/tutorial/consuming_packages.html | 14 +- .../build_simple_cmake_project.html | 14 +- .../cross_building_with_conan.html | 14 +- .../different_configurations.html | 14 +- .../intro_to_versioning.html | 14 +- .../the_flexibility_of_conanfile_py.html | 14 +- .../use_tools_as_conan_packages.html | 14 +- 2.0/tutorial/creating_packages.html | 14 +- .../add_dependencies_to_packages.html | 14 +- .../creating_packages/build_packages.html | 14 +- .../configure_options_settings.html | 14 +- .../create_your_first_package.html | 14 +- .../define_package_information.html | 14 +- .../handle_sources_in_packages.html | 14 +- .../other_types_of_packages.html | 14 +- .../header_only_packages.html | 14 +- .../package_prebuilt_binaries.html | 14 +- .../tool_requires_packages.html | 14 +- .../creating_packages/package_method.html | 14 +- .../preparing_the_build.html | 14 +- .../test_conan_packages.html | 14 +- 2.0/tutorial/developing_packages.html | 14 +- .../editable_packages.html | 14 +- .../local_package_development_flow.html | 14 +- .../developing_packages/package_layout.html | 14 +- 2.0/tutorial/other_features.html | 46 +- 2.0/tutorial/versioning.html | 14 +- 2.0/tutorial/versioning/conflicts.html | 14 +- 2.0/tutorial/versioning/lockfiles.html | 14 +- 2.0/tutorial/versioning/revisions.html | 14 +- 2.0/tutorial/versioning/version_ranges.html | 25 +- 2.0/tutorial/versioning/versions.html | 14 +- 2.0/whatsnew.html | 14 +- 2/.buildinfo | 2 +- 2/404.html | 14 +- 2/Page Not Found.html | 14 +- 2/_sources/changelog.rst.txt | 42 + 2/_sources/devops.rst.txt | 1 + .../backup_sources/sources_backup.rst.txt | 2 + 2/_sources/devops/metadata.rst.txt | 28 +- 2/_sources/devops/save_restore.rst.txt | 59 + 2/_sources/reference/commands/build.rst.txt | 78 +- 2/_sources/reference/commands/cache.rst.txt | 81 ++ 2/_sources/reference/commands/create.rst.txt | 73 +- .../commands/graph/build_order.rst.txt | 184 ++- .../reference/commands/graph/info.rst.txt | 261 +++-- 2/_sources/reference/commands/install.rst.txt | 74 +- 2/_sources/reference/commands/list.rst.txt | 35 +- .../reference/commands/lock/create.rst.txt | 143 +-- 2/_sources/reference/commands/profile.rst.txt | 93 +- 2/_sources/reference/commands/remove.rst.txt | 7 +- 2/_sources/reference/commands/test.rst.txt | 82 +- .../reference/conanfile/attributes.rst.txt | 6 + .../conanfile/methods/source.rst.txt | 2 + .../reference/config_files/settings.rst.txt | 2 +- 2/_sources/reference/tools.rst.txt | 35 +- .../reference/tools/cmake/cmakedeps.rst.txt | 1 + .../tools/cmake/cmaketoolchain.rst.txt | 16 + .../tools/gnu/autotoolstoolchain.rst.txt | 11 +- .../reference/tools/gnu/pkgconfigdeps.rst.txt | 5 +- 2/_sources/reference/tools/google.rst.txt | 11 + .../reference/tools/google/bazel.rst.txt | 51 + .../reference/tools/google/bazeldeps.rst.txt | 268 +++++ .../tools/google/bazeltoolchain.rst.txt | 78 ++ .../tools/system/package_manager.rst.txt | 4 +- 2/_sources/tutorial/other_features.rst.txt | 41 + .../versioning/version_ranges.rst.txt | 10 +- 2/_static/documentation_options.js | 2 +- 2/changelog.html | 80 +- 2/conan.pdf | Bin 3847390 -> 3892331 bytes 2/devops.html | 16 +- .../creating_backup_sources_repo.html | 15 +- 2/devops/backup_sources/sources_backup.html | 16 +- 2/devops/conancenter/hosting_binaries.html | 15 +- 2/devops/metadata.html | 27 +- 2/devops/save_restore.html | 753 ++++++++++++ 2/devops/using_conancenter.html | 15 +- 2/devops/versioning.html | 15 +- 2/devops/versioning/resolve_prereleases.html | 19 +- 2/examples.html | 14 +- 2/examples/commands.html | 14 +- 2/examples/commands/pkglists.html | 14 +- 2/examples/conanfile.html | 14 +- 2/examples/conanfile/layout.html | 14 +- .../layout/conanfile_in_subfolder.html | 14 +- .../conanfile/layout/editable_components.html | 14 +- .../layout/multiple_subprojects.html | 14 +- .../layout/third_party_libraries.html | 14 +- 2/examples/conanfile/package_info.html | 14 +- .../conanfile/package_info/components.html | 14 +- .../package_info_conf_and_env.html | 14 +- 2/examples/config_files.html | 14 +- .../config_files/settings/settings_user.html | 14 +- 2/examples/cross_build.html | 14 +- .../cross_build/android/android_studio.html | 14 +- 2/examples/cross_build/android/ndk.html | 14 +- 2/examples/dev_flow.html | 14 +- .../debug/step_into_dependencies.html | 14 +- 2/examples/extensions.html | 14 +- .../clean/custom_command_clean_revisions.html | 14 +- .../extensions/commands/custom_commands.html | 14 +- .../deployers/builtin_deployers.html | 14 +- .../deployers/custom_deployers.html | 14 +- .../deployers/dev/development_deploy.html | 14 +- .../sources/custom_deployer_sources.html | 14 +- 2/examples/graph.html | 14 +- .../graph/requires/consume_cmake_macro.html | 14 +- .../tool_requires/different_options.html | 14 +- .../tool_requires/different_versions.html | 14 +- .../tool_requires/use_cmake_modules.html | 14 +- .../graph/tool_requires/using_protobuf.html | 14 +- 2/examples/tools.html | 14 +- 2/examples/tools/autotools/autotools.html | 14 +- .../build_project_autotools_toolchain.html | 14 +- 2/examples/tools/cmake/cmake.html | 14 +- .../build_project_cmake_presets.html | 14 +- .../extend_own_cmake_presets.html | 14 +- .../inject_cmake_variables.html | 14 +- 2/examples/tools/files/files.html | 14 +- .../tools/files/patches/patch_sources.html | 14 +- 2/examples/tools/meson/meson.html | 14 +- .../build_simple_meson_project.html | 14 +- .../scm/git/capture_scm/git_capture_scm.html | 14 +- 2/genindex.html | 68 +- 2/index.html | 15 +- 2/installation.html | 14 +- 2/integrations.html | 18 +- 2/integrations/android.html | 14 +- 2/integrations/autotools.html | 14 +- 2/integrations/clion.html | 14 +- 2/integrations/cmake.html | 14 +- 2/integrations/jfrog.html | 14 +- 2/integrations/makefile.html | 14 +- 2/integrations/meson.html | 14 +- 2/integrations/visual_studio.html | 14 +- 2/integrations/xcode.html | 14 +- 2/introduction.html | 14 +- 2/knowledge.html | 14 +- 2/knowledge/cheatsheet.html | 14 +- 2/knowledge/faq.html | 14 +- 2/knowledge/guidelines.html | 14 +- 2/knowledge/videos.html | 14 +- 2/objects.inv | Bin 13426 -> 13797 bytes 2/reference.html | 31 +- 2/reference/binary_model.html | 14 +- .../binary_model/custom_compatibility.html | 14 +- 2/reference/binary_model/dependencies.html | 14 +- 2/reference/binary_model/extending.html | 14 +- 2/reference/binary_model/package_id.html | 14 +- 2/reference/commands.html | 14 +- 2/reference/commands/build.html | 92 +- 2/reference/commands/cache.html | 84 +- 2/reference/commands/config.html | 14 +- 2/reference/commands/create.html | 87 +- 2/reference/commands/download.html | 14 +- 2/reference/commands/editable.html | 14 +- 2/reference/commands/export-pkg.html | 14 +- 2/reference/commands/export.html | 14 +- .../formatters/graph_info_json_formatter.html | 14 +- 2/reference/commands/graph.html | 14 +- 2/reference/commands/graph/build_order.html | 198 +++- .../commands/graph/build_order_merge.html | 14 +- 2/reference/commands/graph/info.html | 91 +- 2/reference/commands/inspect.html | 14 +- 2/reference/commands/install.html | 88 +- 2/reference/commands/list.html | 44 +- 2/reference/commands/lock.html | 14 +- 2/reference/commands/lock/add.html | 14 +- 2/reference/commands/lock/create.html | 157 +-- 2/reference/commands/lock/merge.html | 14 +- 2/reference/commands/new.html | 14 +- 2/reference/commands/profile.html | 107 +- 2/reference/commands/remote.html | 14 +- 2/reference/commands/remove.html | 21 +- 2/reference/commands/search.html | 14 +- 2/reference/commands/source.html | 14 +- 2/reference/commands/test.html | 96 +- 2/reference/commands/upload.html | 14 +- 2/reference/commands/version.html | 14 +- 2/reference/conan_server.html | 14 +- 2/reference/conanfile.html | 14 +- 2/reference/conanfile/attributes.html | 50 +- 2/reference/conanfile/methods.html | 14 +- 2/reference/conanfile/methods/build.html | 14 +- 2/reference/conanfile/methods/build_id.html | 14 +- .../conanfile/methods/build_requirements.html | 14 +- .../conanfile/methods/compatibility.html | 14 +- .../conanfile/methods/config_options.html | 14 +- 2/reference/conanfile/methods/configure.html | 14 +- 2/reference/conanfile/methods/export.html | 14 +- .../conanfile/methods/export_sources.html | 14 +- 2/reference/conanfile/methods/generate.html | 14 +- 2/reference/conanfile/methods/init.html | 14 +- 2/reference/conanfile/methods/layout.html | 14 +- 2/reference/conanfile/methods/package.html | 14 +- 2/reference/conanfile/methods/package_id.html | 14 +- .../conanfile/methods/package_info.html | 14 +- .../conanfile/methods/requirements.html | 14 +- 2/reference/conanfile/methods/set_name.html | 14 +- .../conanfile/methods/set_version.html | 14 +- 2/reference/conanfile/methods/source.html | 15 +- .../methods/system_requirements.html | 14 +- 2/reference/conanfile/methods/test.html | 14 +- 2/reference/conanfile/methods/validate.html | 14 +- .../conanfile/methods/validate_build.html | 14 +- 2/reference/conanfile/running_and_output.html | 14 +- 2/reference/conanfile_txt.html | 14 +- 2/reference/config_files.html | 18 +- 2/reference/config_files/conanrc.html | 14 +- 2/reference/config_files/credentials.html | 14 +- 2/reference/config_files/global_conf.html | 14 +- 2/reference/config_files/profiles.html | 14 +- 2/reference/config_files/remotes.html | 14 +- 2/reference/config_files/settings.html | 16 +- .../config_files/source_credentials.html | 14 +- 2/reference/environment.html | 14 +- 2/reference/extensions.html | 14 +- .../extensions/binary_compatibility.html | 14 +- 2/reference/extensions/command_wrapper.html | 14 +- 2/reference/extensions/custom_commands.html | 14 +- 2/reference/extensions/custom_generators.html | 14 +- 2/reference/extensions/deployers.html | 14 +- 2/reference/extensions/hooks.html | 14 +- 2/reference/extensions/package_signing.html | 14 +- 2/reference/extensions/profile_plugin.html | 14 +- 2/reference/extensions/python_api.html | 14 +- .../extensions/python_api/ConanAPI.html | 14 +- .../extensions/python_api/ConfigAPI.html | 24 +- .../extensions/python_api/DownloadAPI.html | 14 +- .../extensions/python_api/ExportAPI.html | 14 +- .../extensions/python_api/GraphAPI.html | 14 +- .../extensions/python_api/InstallAPI.html | 14 +- .../extensions/python_api/ListAPI.html | 14 +- 2/reference/extensions/python_api/NewAPI.html | 14 +- .../extensions/python_api/ProfilesAPI.html | 14 +- .../extensions/python_api/RemotesAPI.html | 14 +- .../extensions/python_api/RemoveAPI.html | 14 +- .../extensions/python_api/SearchAPI.html | 14 +- .../extensions/python_api/UploadAPI.html | 14 +- 2/reference/extensions/python_requires.html | 14 +- 2/reference/tools.html | 119 +- 2/reference/tools/android.html | 39 +- 2/reference/tools/apple.html | 35 +- 2/reference/tools/apple/other.html | 35 +- 2/reference/tools/apple/xcodebuild.html | 31 +- 2/reference/tools/apple/xcodedeps.html | 31 +- 2/reference/tools/apple/xcodetoolchain.html | 31 +- 2/reference/tools/build.html | 39 +- 2/reference/tools/cmake.html | 35 +- 2/reference/tools/cmake/cmake.html | 34 +- 2/reference/tools/cmake/cmake_layout.html | 35 +- 2/reference/tools/cmake/cmakedeps.html | 32 +- 2/reference/tools/cmake/cmaketoolchain.html | 47 +- 2/reference/tools/cpp_info.html | 39 +- 2/reference/tools/env.html | 35 +- 2/reference/tools/env/environment.html | 31 +- 2/reference/tools/env/envvars.html | 31 +- 2/reference/tools/env/virtualbuildenv.html | 31 +- 2/reference/tools/env/virtualrunenv.html | 35 +- 2/reference/tools/files.html | 35 +- 2/reference/tools/files/basic.html | 31 +- 2/reference/tools/files/checksum.html | 31 +- 2/reference/tools/files/downloads.html | 31 +- 2/reference/tools/files/packaging.html | 35 +- 2/reference/tools/files/patches.html | 31 +- 2/reference/tools/files/symlinks.html | 31 +- 2/reference/tools/gnu.html | 37 +- 2/reference/tools/gnu/autotools.html | 33 +- 2/reference/tools/gnu/autotoolsdeps.html | 33 +- 2/reference/tools/gnu/autotoolstoolchain.html | 41 +- 2/reference/tools/gnu/makedeps.html | 33 +- 2/reference/tools/gnu/pkgconfig.html | 37 +- 2/reference/tools/gnu/pkgconfigdeps.html | 38 +- 2/reference/tools/google.html | 749 ++++++++++++ 2/reference/tools/google/bazel.html | 818 +++++++++++++ 2/reference/tools/google/bazeldeps.html | 1020 +++++++++++++++++ 2/reference/tools/google/bazeltoolchain.html | 888 ++++++++++++++ 2/reference/tools/intel.html | 39 +- 2/reference/tools/layout.html | 39 +- 2/reference/tools/meson.html | 35 +- 2/reference/tools/meson/meson.html | 35 +- 2/reference/tools/meson/mesontoolchain.html | 31 +- 2/reference/tools/microsoft.html | 35 +- 2/reference/tools/microsoft/helpers.html | 31 +- 2/reference/tools/microsoft/msbuild.html | 31 +- 2/reference/tools/microsoft/msbuilddeps.html | 31 +- .../tools/microsoft/msbuildtoolchain.html | 31 +- 2/reference/tools/microsoft/nmake.html | 31 +- 2/reference/tools/microsoft/vcvars.html | 31 +- .../tools/microsoft/visual_layout.html | 31 +- 2/reference/tools/scm.html | 31 +- 2/reference/tools/scm/git.html | 31 +- 2/reference/tools/scm/version.html | 35 +- 2/reference/tools/scons.html | 39 +- 2/reference/tools/system.html | 39 +- 2/reference/tools/system/package_manager.html | 43 +- 2/search.html | 14 +- 2/searchindex.js | 2 +- 2/sitemap.xml | 2 +- 2/tutorial.html | 15 +- 2/tutorial/conan_repositories.html | 14 +- .../conan_repositories/conan_center.html | 14 +- .../setting_up_conan_remotes.html | 14 +- .../artifactory/artifactory_ce_cpp.html | 14 +- .../conan_server.html | 14 +- .../uploading_packages.html | 14 +- 2/tutorial/consuming_packages.html | 14 +- .../build_simple_cmake_project.html | 14 +- .../cross_building_with_conan.html | 14 +- .../different_configurations.html | 14 +- .../intro_to_versioning.html | 14 +- .../the_flexibility_of_conanfile_py.html | 14 +- .../use_tools_as_conan_packages.html | 14 +- 2/tutorial/creating_packages.html | 14 +- .../add_dependencies_to_packages.html | 14 +- .../creating_packages/build_packages.html | 14 +- .../configure_options_settings.html | 14 +- .../create_your_first_package.html | 14 +- .../define_package_information.html | 14 +- .../handle_sources_in_packages.html | 14 +- .../other_types_of_packages.html | 14 +- .../header_only_packages.html | 14 +- .../package_prebuilt_binaries.html | 14 +- .../tool_requires_packages.html | 14 +- .../creating_packages/package_method.html | 14 +- .../preparing_the_build.html | 14 +- .../test_conan_packages.html | 14 +- 2/tutorial/developing_packages.html | 14 +- .../editable_packages.html | 14 +- .../local_package_development_flow.html | 14 +- .../developing_packages/package_layout.html | 14 +- 2/tutorial/other_features.html | 46 +- 2/tutorial/versioning.html | 14 +- 2/tutorial/versioning/conflicts.html | 14 +- 2/tutorial/versioning/lockfiles.html | 14 +- 2/tutorial/versioning/revisions.html | 14 +- 2/tutorial/versioning/version_ranges.html | 25 +- 2/tutorial/versioning/versions.html | 14 +- 2/whatsnew.html | 14 +- 404.html | 14 +- 613 files changed, 19196 insertions(+), 4888 deletions(-) create mode 100644 2.0/_sources/devops/save_restore.rst.txt create mode 100644 2.0/_sources/reference/tools/google.rst.txt create mode 100644 2.0/_sources/reference/tools/google/bazel.rst.txt create mode 100644 2.0/_sources/reference/tools/google/bazeldeps.rst.txt create mode 100644 2.0/_sources/reference/tools/google/bazeltoolchain.rst.txt create mode 100644 2.0/devops/save_restore.html create mode 100644 2.0/reference/tools/google.html create mode 100644 2.0/reference/tools/google/bazel.html create mode 100644 2.0/reference/tools/google/bazeldeps.html create mode 100644 2.0/reference/tools/google/bazeltoolchain.html create mode 100644 2/_sources/devops/save_restore.rst.txt create mode 100644 2/_sources/reference/tools/google.rst.txt create mode 100644 2/_sources/reference/tools/google/bazel.rst.txt create mode 100644 2/_sources/reference/tools/google/bazeldeps.rst.txt create mode 100644 2/_sources/reference/tools/google/bazeltoolchain.rst.txt create mode 100644 2/devops/save_restore.html create mode 100644 2/reference/tools/google.html create mode 100644 2/reference/tools/google/bazel.html create mode 100644 2/reference/tools/google/bazeldeps.html create mode 100644 2/reference/tools/google/bazeltoolchain.html diff --git a/2.0/.buildinfo b/2.0/.buildinfo index 57bf27accf6..848b3646056 100644 --- a/2.0/.buildinfo +++ b/2.0/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 5c0406813aeb8ed05397e4d40841e8fd +config: 960defcc7e8809327296f77132e043e8 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/2.0/404.html b/2.0/404.html index c4624b77ae3..5d3eff87f44 100644 --- a/2.0/404.html +++ b/2.0/404.html @@ -10,7 +10,7 @@ - Page Not Found — conan 2.0.13 documentation + Page Not Found — conan 2.0.14 documentation @@ -45,7 +45,7 @@ - + + + + + + + + + + + + + + + + +
+ + + + +
+ + + + + + + +
+
+ + + + + + + + + + + + + + + + + + + + +
+
+ +
+

Save and restore packages from/to the cache

+
+

Warning

+

This feature is experimental and subject to breaking changes. +See the Conan stability section for more information.

+
+

With the conan cache save and conan cache restore commands, it is possible to create a .tgz from one or several packages from a Conan cache and later restore those packages into another Conan cache. There are some scenarios this can be useful:

+
    +
  • In Continuous Integration, specially if doing distributed builds, it might be very convenient to be able to move temporary packages recently built. Most CI systems have the capability of transferring files between jobs for this purpose. The Conan cache is not concurrent, sometimes for paralllel jobs different caches have to be used.
    • +
  • For air-gapped setups, in which packages can only be transferred via client side.
    • +
  • Developers directly sharing some packages with other developers for testing or inspection.
    • +
+

The process of saving the packages is using the conan cache save command. +It can use a pattern, like the conan list command, but it can also accept a package-list, like other commands like remove, upload, download. For example:

+
$ conan cache save "pkg/*:*"
+Saving pkg/1.0: p/pkg1df6df1a3b33c
+Saving pkg/1.0:9a4eb3c8701508aa9458b1a73d0633783ecc2270: p/b/pkgd573962ec2c90/p
+Saving pkg/1.0:9a4eb3c8701508aa9458b1a73d0633783ecc2270 metadata: p/b/pkgd573962ec2c90/p
+...
+# creates conan_cache_save.tgz
+
+
+

The conan_cache_save.tgz file contains the packages named pkg (any version), the last recipe revision, and the last package revision of all the package binaries. +The name of the file can be changed with the optional --file=xxxx argument. Some important considerations:

+
    +
  • The command saves the contents of the cache “recipe” folders, containing the subfolders “export”, “export_sources”, “download”, “source” and recipe “metadata”.
    • +
  • The command saves the contents of the “package” and the package “metadata” folders, but not the binary “build” or “download”, that are considered temporary folders.
    • +
  • If the user doesn’t want any of those folders to be saved, they can be cleaned before saving them with conan cache clean command
    • +
  • The command saves the cache files and artifacts as well as the metadata (revisions, package_id) to be able to restore those packages in another cache. But it doesn’t save any other cache state like settings.yml, global.conf, remotes, etc. If the saved packages require any other specific configuration, it should be managed with conan config install.
    • +
+

We can move this conan_cache_save.tgz file to another Conan cache and restore it as:

+
$ conan cache restore conan_cache_save.tgz
+Restore: pkg/1.0 in p/pkg1df6df1a3b33c
+Restore: pkg/1.0:9a4eb3c8701508aa9458b1a73d0633783ecc2270 in p/b/pkg773791b8c97aa/p
+Restore: pkg/1.0:9a4eb3c8701508aa9458b1a73d0633783ecc2270 metadata in p/b/pkg773791b8c97aa/d/metadata
+...
+
+
+

The restore process will overwrite existing packages if they already exist in the cache.

+
+

Note

+

Best practices

+
    +
  • Saving and restoring packages is not a substitute for proper storage (upload) of packages in a Conan server repository. +It is only intended as a transitory mechanism, in CI systems, to save an air-gap, etc., but not as a long-term storage +and retrieval.
    • +
  • Saving and restoring packages is not a substitute for proper backup of server repositories. The recommended way to +implement long term backup of Conan packages is using some server side backup strategy.
    • +
  • The storage format and serialization is not guaranteed at this moment to be future-proof and stable. It is expected +to work in the same Conan version, but future Conan versions might break the storage format created with previous versions. +(this is aligned with the above recommendation to not use it as a backup strategy)
    • +
+
+
+ + +
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ + + Version: 2.0 + + +
+
+
Versions
+ + +
2.0
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
2
+ + +
+ + + + +
1
+ + + +
1.62
+ + + +
1.61
+ + + +
1.60
+ + + +
1.59
+ + + +
1.58
+ + + +
1.57
+ + + +
1.56
+ + + +
1.55
+ + + +
1.54
+ + + +
1.53
+ + + +
1.52
+ + + +
1.51
+ + + +
1.50
+ + + +
1.49
+ + + +
1.48
+ + + +
1.47
+ + + +
1.46
+ + + +
1.45
+ + + +
1.44
+ + + +
1.43
+ + + +
1.42
+ + + +
1.41
+ + + +
1.40
+ + + +
1.39
+ + + +
1.38
+ + + +
1.37
+ + + +
1.36
+ + + +
1.35
+ + + +
1.34
+ + + +
1.33
+ + + +
1.32
+ + + +
1.31
+ + + +
1.30
+ + + +
1.29
+ + + +
1.28
+ + + +
1.27
+ + + +
1.26
+ + + +
1.25
+ + + +
1.24
+ + + +
1.23
+ + + +
1.22
+ + + +
1.21
+ + + +
1.20
+ + + +
1.19
+ + + +
1.18
+ + + +
1.17
+ + + +
1.16
+ + + +
1.15
+ + + +
1.14
+ + + +
1.13
+ + + +
1.12
+ + + +
1.11
+ + + +
1.10
+ + + +
1.9
+ + + +
1.8
+ + + +
1.7
+ + + +
1.6
+ + + +
1.5
+ + + +
1.4
+ + + +
1.3
+ + + + +
+
+
Downloads
+ +
PDF
+ +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/2.0/devops/using_conancenter.html b/2.0/devops/using_conancenter.html index 055f3c8407b..1e4dfae458c 100644 --- a/2.0/devops/using_conancenter.html +++ b/2.0/devops/using_conancenter.html @@ -10,7 +10,7 @@ - Using ConanCenter packages in production environments — conan 2.0.13 documentation + Using ConanCenter packages in production environments — conan 2.0.14 documentation @@ -45,7 +45,7 @@ - + @@ -120,6 +120,7 @@
  • Backing up third-party sources with Conan
  • Managing package metadata files
  • Versioning
    • +
  • Save and restore packages from/to the cache
  • Integrations
    • @@ -342,7 +343,7 @@

    Control and customization

    © Copyright 2016-2023, JFrog. - Last updated on Nov 03, 2023. + Last updated on Nov 14, 2023. Cookies Settings

    @@ -487,6 +488,8 @@

    Control and customization1.62 + + +
    1.61
    @@ -755,7 +762,7 @@

    Control and customization var DOCUMENTATION_OPTIONS = { URL_ROOT:'../', - VERSION:'2.0.13', + VERSION:'2.0.14', COLLAPSE_INDEX:false, FILE_SUFFIX:'.html', HAS_SOURCE: true, diff --git a/2.0/devops/versioning.html b/2.0/devops/versioning.html index 96365a67b7d..fa96c630e1c 100644 --- a/2.0/devops/versioning.html +++ b/2.0/devops/versioning.html @@ -10,7 +10,7 @@ - Versioning — conan 2.0.13 documentation + Versioning — conan 2.0.14 documentation @@ -45,7 +45,7 @@ - + @@ -120,6 +120,7 @@
  • Handling version ranges and pre-releases
    • +
  • Save and restore packages from/to the cache
  • Integrations
    • @@ -240,7 +241,7 @@

    © Copyright 2016-2023, JFrog. - Last updated on Nov 03, 2023. + Last updated on Nov 14, 2023. Cookies Settings

    @@ -385,6 +386,8 @@ + + @@ -401,6 +404,10 @@ +
    1.62
    + + +
    1.61
    @@ -653,7 +660,7 @@ + + + + + + + + + + + + + + + +
    + + + + +
    + + + + + + + +
    +
    + + + + + + + + + + + + + + + + + + + + +
    +
    + + + + +
    +
    + +
    +
    + + +
    +
    + +
    + +
    + +
    + + + Version: 2.0 + + +
    +
    +
    Versions
    + + +
    2.0
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    2
    + + +
    + + + + +
    1
    + + + +
    1.62
    + + + +
    1.61
    + + + +
    1.60
    + + + +
    1.59
    + + + +
    1.58
    + + + +
    1.57
    + + + +
    1.56
    + + + +
    1.55
    + + + +
    1.54
    + + + +
    1.53
    + + + +
    1.52
    + + + +
    1.51
    + + + +
    1.50
    + + + +
    1.49
    + + + +
    1.48
    + + + +
    1.47
    + + + +
    1.46
    + + + +
    1.45
    + + + +
    1.44
    + + + +
    1.43
    + + + +
    1.42
    + + + +
    1.41
    + + + +
    1.40
    + + + +
    1.39
    + + + +
    1.38
    + + + +
    1.37
    + + + +
    1.36
    + + + +
    1.35
    + + + +
    1.34
    + + + +
    1.33
    + + + +
    1.32
    + + + +
    1.31
    + + + +
    1.30
    + + + +
    1.29
    + + + +
    1.28
    + + + +
    1.27
    + + + +
    1.26
    + + + +
    1.25
    + + + +
    1.24
    + + + +
    1.23
    + + + +
    1.22
    + + + +
    1.21
    + + + +
    1.20
    + + + +
    1.19
    + + + +
    1.18
    + + + +
    1.17
    + + + +
    1.16
    + + + +
    1.15
    + + + +
    1.14
    + + + +
    1.13
    + + + +
    1.12
    + + + +
    1.11
    + + + +
    1.10
    + + + +
    1.9
    + + + +
    1.8
    + + + +
    1.7
    + + + +
    1.6
    + + + +
    1.5
    + + + +
    1.4
    + + + +
    1.3
    + + + + +
    +
    +
    Downloads
    + +
    PDF
    + +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/2.0/reference/tools/google/bazel.html b/2.0/reference/tools/google/bazel.html new file mode 100644 index 00000000000..0c578f31e1a --- /dev/null +++ b/2.0/reference/tools/google/bazel.html @@ -0,0 +1,818 @@ + + + + + + + + + + + + + Bazel — conan 2.0.14 documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + +
    + + + + + + + +
    +
    + + + + + + + + + + + + + + + + + + + + +
    +
    + +
    +

    Bazel

    +
    +

    Warning

    +

    This feature is experimental and subject to breaking changes. +See the Conan stability section for more information.

    +
    +

    The Bazel build helper is a wrapper around the command line invocation of bazel. It will abstract the +calls like bazel <rcpaths> build <configs> <targets> into Python method calls.

    +

    The helper is intended to be used in the conanfile.py build() method, to call Bazel commands automatically +when a package is being built directly by Conan (create, install)

    +
    from conan import ConanFile
+from conan.tools.google import Bazel
+
+class App(ConanFile):
+    settings = "os", "arch", "compiler", "build_type"
+
+    def build(self):
+        bz = Bazel(self)
+        bz.build(target="//main:hello-world")
+
    +
    +
    +

    Reference

    +
    +
    +class Bazel(conanfile)
    +
    +++ + + + +
    Parameters:conanfile – < ConanFile object > The current recipe object. Always use self.
    +
    +
    +build(args=None, target='//...', clean=True)
    +

    Runs “bazel <rcpaths> build <configs> <args> <targets>” command where:

    +
      +
    • rcpaths: adds --bazelrc=xxxx per rc-file path. It listens to BazelToolchain +(--bazelrc=conan_bzl.rc), and tools.google.bazel:bazelrc_path conf.
      • +
    • configs: adds --config=xxxx per bazel-build configuration. +It listens to BazelToolchain (--config=conan-config), and +tools.google.bazel:configs conf.
      • +
    • args: they are any extra arguments to add to the bazel build execution.
      • +
    • targets: all the target labels.
      • +
    + +++ + + + +
    Parameters:
      +
    • target – It is the target label. By default, it’s “//…” which runs all the targets.
      • +
    • args – list of extra arguments to pass to the CLI.
      • +
    • clean – boolean that indicates to run a “bazel clean” before running the “bazel build”. +Notice that this is important to ensure a fresh bazel cache every
      • +
    +
    +
    + +
    +
    +test(target=None)
    +

    Runs “bazel test <targets>” command.

    +
    + +
    + +
    +

    Properties

    +

    The following properties affect the Bazel build helper:

    +
      +
    • tools.build:skip_test=<bool> (boolean) if True, it runs the bazel test <target>.
      • +
    +
    +
    +

    conf

    +

    Bazel is affected by these [conf] variables:

    +
      +
    • tools.google.bazel:bazelrc_path: List of paths to other bazelrc files to be used as bazel --bazelrc=rcpath1 ... build.
      • +
    • tools.google.bazel:configs: List of Bazel configurations to be used as bazel build --config=config1 ....
      • +
    +
    +
    +
    + + +
    +
    + +
    +
    + + +
    +
    + +
    + +
    + +
    + + + Version: 2.0 + + +
    +
    +
    Versions
    + + +
    2.0
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    2
    + + +
    + + + + +
    1
    + + + +
    1.62
    + + + +
    1.61
    + + + +
    1.60
    + + + +
    1.59
    + + + +
    1.58
    + + + +
    1.57
    + + + +
    1.56
    + + + +
    1.55
    + + + +
    1.54
    + + + +
    1.53
    + + + +
    1.52
    + + + +
    1.51
    + + + +
    1.50
    + + + +
    1.49
    + + + +
    1.48
    + + + +
    1.47
    + + + +
    1.46
    + + + +
    1.45
    + + + +
    1.44
    + + + +
    1.43
    + + + +
    1.42
    + + + +
    1.41
    + + + +
    1.40
    + + + +
    1.39
    + + + +
    1.38
    + + + +
    1.37
    + + + +
    1.36
    + + + +
    1.35
    + + + +
    1.34
    + + + +
    1.33
    + + + +
    1.32
    + + + +
    1.31
    + + + +
    1.30
    + + + +
    1.29
    + + + +
    1.28
    + + + +
    1.27
    + + + +
    1.26
    + + + +
    1.25
    + + + +
    1.24
    + + + +
    1.23
    + + + +
    1.22
    + + + +
    1.21
    + + + +
    1.20
    + + + +
    1.19
    + + + +
    1.18
    + + + +
    1.17
    + + + +
    1.16
    + + + +
    1.15
    + + + +
    1.14
    + + + +
    1.13
    + + + +
    1.12
    + + + +
    1.11
    + + + +
    1.10
    + + + +
    1.9
    + + + +
    1.8
    + + + +
    1.7
    + + + +
    1.6
    + + + +
    1.5
    + + + +
    1.4
    + + + +
    1.3
    + + + + +
    +
    +
    Downloads
    + +
    PDF
    + +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/2.0/reference/tools/google/bazeldeps.html b/2.0/reference/tools/google/bazeldeps.html new file mode 100644 index 00000000000..c672b09680c --- /dev/null +++ b/2.0/reference/tools/google/bazeldeps.html @@ -0,0 +1,1020 @@ + + + + + + + + + + + + + BazelDeps — conan 2.0.14 documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + +
    + + + + + + + +
    +
    + + + + + + + + + + + + + + + + + + + + +
    +
    + +
    +

    BazelDeps

    +
    +

    Warning

    +

    This feature is experimental and subject to breaking changes. +See the Conan stability section for more information.

    +
    +

    The BazelDeps is the dependencies generator for Bazel. Generates a <REPOSITORY>/BUILD.bazel file per dependency, +where the <REPOSITORY>/ folder is the Conan recipe reference name by default, e.g., mypkg/BUILD.bazel. Apart from +that, it also generates a dependencies.bzl file which contains a Bazel function to load all your Conan dependencies.

    +

    The BazelDeps generator can be used by name in conanfiles:

    +
    +
    conanfile.py
    +
    class Pkg(ConanFile):
+    generators = "BazelDeps"
+
    +
    +
    +
    +
    conanfile.txt
    +
    [generators]
+BazelDeps
+
    +
    +
    +

    And it can also be fully instantiated in the conanfile generate() method:

    +
    from conan import ConanFile
+from conan.tools.google import BazelDeps
+
+class App(ConanFile):
+    settings = "os", "arch", "compiler", "build_type"
+    requires = "zlib/1.2.11"
+
+    def generate(self):
+        bz = BazelDeps(self)
+        bz.generate()
+
    +
    +
    +

    Generated files

    +

    When the BazelDeps generator is used, every invocation of conan install will +generate several bazel files. For the conanfile.py +above, for example:

    +
    $ conan install .
+.
+├── BUILD.bazel
+├── conanfile.py
+├── dependencies.bzl
+└── zlib
+    └── BUILD.bazel
+
    +
    +

    Every conan install generates these files:

    +
      +
    • BUILD.bazel: An empty file aimed to be alongside the dependencies.bzl one. +More information here.
      • +
    • dependencies.bzl: this file tells your Bazel WORKSPACE how to load the dependencies.
      • +
    • zlib/BUILD.bazel: contains all the targets that you can load from any of your BUILD files. More information in +Customization.
      • +
    +

    Let’s check the content of the files created:

    +
    +
    dependencies.bzl
    +
    # This Bazel module should be loaded by your WORKSPACE file.
+# Add these lines to your WORKSPACE one (assuming that you're using the "bazel_layout"):
+# load("@//conan:dependencies.bzl", "load_conan_dependencies")
+# load_conan_dependencies()
+
+def load_conan_dependencies():
+    native.new_local_repository(
+        name="zlib",
+        path="/path/to/conan/package/folder/",
+        build_file="/your/current/working/directory/zlib/BUILD.bazel",
+    )
+
    +
    +
    +

    Given the example above, and imagining that your WORKSPACE is at the same directory, you would have to add these lines in there:

    +
    +
    WORKSPACE
    +
    load("@//:dependencies.bzl", "load_conan_dependencies")
+load_conan_dependencies()
+
    +
    +
    +
    +
    zlib/BUILD.bazel
    +
    load("@rules_cc//cc:defs.bzl", "cc_import", "cc_library")
+
+# Components precompiled libs
+# Root package precompiled libs
+cc_import(
+    name = "z_precompiled",
+    static_library = "lib/libz.a",
+)
+
+# Components libraries declaration
+# Package library declaration
+cc_library(
+    name = "zlib",
+    hdrs = glob([
+        "include/**",
+    ]),
+    includes = [
+        "include",
+    ],
+    visibility = ["//visibility:public"],
+    deps = [
+        ":z_precompiled",
+    ],
+)
+
+# Filegroup library declaration
+filegroup(
+    name = "zlib_binaries",
+    srcs = glob([
+        "bin/**",
+    ]),
+    visibility = ["//visibility:public"],
+)
+
    +
    +
    +

    As you can observe, the zlib/BUILD.bazel defines these global targets:

    +
      +
    • zlib: bazel library target. The label used to depend on it would be @zlib//:zlib.
      • +
    • zlib_binaries: bazel filegroup target. The label used to depend on it would be @zlib//:zlib_binaries.
      • +
    +

    You can put all the files generated by BazelDeps into another folder using the bazel_layout:

    +
    +
    conanfile.py
    +
    from conan import ConanFile
+from conan.tools.google import BazelDeps, bazel_layout
+
+class App(ConanFile):
+    settings = "os", "arch", "compiler", "build_type"
+    requires = "zlib/1.2.11"
+
+    def layout(self):
+        bazel_layout(self)
+
+    def generate(self):
+        bz = BazelDeps(self)
+        bz.generate()
+
    +
    +
    +

    Running again the conan install command, we now get this structure:

    +
    $ conan install .
+.
+├── conan
+│   ├── BUILD.bazel
+│   ├── dependencies.bzl
+│   └── zlib
+│       └── BUILD.bazel
+└── conanfile.py
+
    +
    +

    Now your Conan-bazel files were generated in the conan/ folder, so your WORKSPACE will look like:

    +
    +
    WORKSPACE
    +
    load("@//conan:dependencies.bzl", "load_conan_dependencies")
+load_conan_dependencies()
+
    +
    +
    +
    +
    +

    Customization

    +
    +

    Naming

    +

    The <REPOSITORY>/BUILD.bazel file contains all the targets declared by the dependency. Both the <REPOSITORY>/ folder and the targets +declared in there will be named following these rules by default:

    +
      +
    • +
      For packages, it uses the package name as folder/target name, e.g., package zlib/1.2.11 will have:
      +
        +
      • Folder: zlib/BUILD.bazel.
        • +
      • Global target: zlib.
        • +
      • How it can be consumed: @zlib//:zlib.
        • +
      +
      +
      +
      • +
    • +
      For components, the package name + hyphen + component name, e.g., package openssl/3.1.4 will have:
      +
        +
      • Folder: openssl/BUILD.bazel.
        • +
      • Global target: openssl.
        • +
      • Components targets: openssl-ssl, and openssl-crypto.
        • +
      • +
        How it can be consumed:
        +
          +
        • @openssl//:openssl (global one which includes all the components)
          • +
        • @openssl//:openssl-ssl (component one)
          • +
        • @openssl//:openssl-crypto (component one)
          • +
        +
        +
        +
        • +
      +
      +
      +
      • +
    +

    You can change that default behavior with the bazel_target_name and the bazel_repository_name properties. +See Properties section below.

    +
    +
    +
    +

    Reference

    +
    +
    +class BazelDeps(conanfile)
    +
    +++ + + + +
    Parameters:conanfile – < ConanFile object > The current recipe object. Always use self.
    +
    +
    +build_context_activated = None
    +

    Activates the build context for the specified Conan package names.

    +
    + +
    +
    +generate()
    +

    Generates all the targets <DEP>/BUILD.bazel files and the dependencies.bzl one in the +build folder. It’s important to highlight that the dependencies.bzl file should be loaded +by your WORKSPACE Bazel file:

    +
    load("@//[BUILD_FOLDER]:dependencies.bzl", "load_conan_dependencies")
+load_conan_dependencies()
+
    +
    +
    + +
    + +
    +

    build_context_activated

    +

    When you have a build-requirement, by default, the Bazel files are not generated. +But you can activate it using the build_context_activated attribute:

    +
    def build_requirements(self):
+    self.tool_requires("my_tool/0.0.1")
+
+def layout(self):
+    bazel_layout(self)
+
+def generate(self):
+    bz = BazelDeps(self)
+    # generate the build-mytool/BUILD.bazel file for the tool require
+    bz.build_context_activated = ["my_tool"]
+    bz.generate()
+
    +
    +

    Running the conan install command, the structure created is as follows:

    +
    $ conan install . -pr:b default
+.
+├── conan
+│   ├── BUILD.bazel
+│   ├── build-my_tool
+│   │   └── BUILD.bazel
+│   └── dependencies.bzl
+└── conanfile.py
+
    +
    +

    Notice that my_tool Bazel folder is prefixed with build- which indicates that it’s being used in the build context.

    +
    +
    +

    Properties

    +

    The following properties affect the BazelDeps generator:

    +
      +
    • bazel_target_name property will define the name of the target declared in the <REPOSITORY>/BUILD.bazel. +This property can be defined at both global and component cpp_info level.
      • +
    • bazel_repository_name property will define the name of the folder where the dependency BUILD.bazel will be +allocated. This property can only be defined at global cpp_info level.
      • +
    +

    Example:

    +
    def package_info(self):
+    self.cpp_info.set_property("bazel_target_name", "my_target")
+    self.cpp_info.set_property("bazel_repository_name", "my_repo")
+    self.cpp_info.components["mycomponent"].set_property("bazel_target_name", "component_name")
+
    +
    +
    +
    +
    + + +
    +
    + +
    +
    + + +
    +
    + +
    + +
    + +
    + + + Version: 2.0 + + +
    +
    +
    Versions
    + + +
    2.0
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    2
    + + +
    + + + + +
    1
    + + + +
    1.62
    + + + +
    1.61
    + + + +
    1.60
    + + + +
    1.59
    + + + +
    1.58
    + + + +
    1.57
    + + + +
    1.56
    + + + +
    1.55
    + + + +
    1.54
    + + + +
    1.53
    + + + +
    1.52
    + + + +
    1.51
    + + + +
    1.50
    + + + +
    1.49
    + + + +
    1.48
    + + + +
    1.47
    + + + +
    1.46
    + + + +
    1.45
    + + + +
    1.44
    + + + +
    1.43
    + + + +
    1.42
    + + + +
    1.41
    + + + +
    1.40
    + + + +
    1.39
    + + + +
    1.38
    + + + +
    1.37
    + + + +
    1.36
    + + + +
    1.35
    + + + +
    1.34
    + + + +
    1.33
    + + + +
    1.32
    + + + +
    1.31
    + + + +
    1.30
    + + + +
    1.29
    + + + +
    1.28
    + + + +
    1.27
    + + + +
    1.26
    + + + +
    1.25
    + + + +
    1.24
    + + + +
    1.23
    + + + +
    1.22
    + + + +
    1.21
    + + + +
    1.20
    + + + +
    1.19
    + + + +
    1.18
    + + + +
    1.17
    + + + +
    1.16
    + + + +
    1.15
    + + + +
    1.14
    + + + +
    1.13
    + + + +
    1.12
    + + + +
    1.11
    + + + +
    1.10
    + + + +
    1.9
    + + + +
    1.8
    + + + +
    1.7
    + + + +
    1.6
    + + + +
    1.5
    + + + +
    1.4
    + + + +
    1.3
    + + + + +
    +
    +
    Downloads
    + +
    PDF
    + +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/2.0/reference/tools/google/bazeltoolchain.html b/2.0/reference/tools/google/bazeltoolchain.html new file mode 100644 index 00000000000..1452aa2f0f6 --- /dev/null +++ b/2.0/reference/tools/google/bazeltoolchain.html @@ -0,0 +1,888 @@ + + + + + + + + + + + + + BazelToolchain — conan 2.0.14 documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + +
    + + + + + + + +
    +
    + + + + + + + + + + + + + + + + + + + + +
    +
    + +
    +

    BazelToolchain

    +
    +

    Warning

    +

    This feature is experimental and subject to breaking changes. +See the Conan stability section for more information.

    +
    +

    The BazelToolchain is the toolchain generator for Bazel. It will generate a conan_bzl.rc file that contains +a build configuration conan-config to inject all the parameters into the bazel build command.

    +

    The BazelToolchain generator can be used by name in conanfiles:

    +
    +
    conanfile.py
    +
    class Pkg(ConanFile):
+    generators = "BazelToolchain"
+
    +
    +
    +
    +
    conanfile.txt
    +
    [generators]
+BazelToolchain
+
    +
    +
    +

    And it can also be fully instantiated in the conanfile generate() method:

    +
    +
    conanfile.py
    +
    from conan import ConanFile
+from conan.tools.google import BazelToolchain
+
+class App(ConanFile):
+    settings = "os", "arch", "compiler", "build_type"
+
+    def generate(self):
+        tc = BazelToolchain(self)
+        tc.generate()
+
    +
    +
    +
    +

    Generated files

    +

    After running conan install command, the BazelToolchain generates the conan_bzl.rc file +that contains Bazel build parameters (it will depend on your current Conan settings and options from your default profile):

    +
    +
    conan_bzl.rc
    +
    # Automatic bazelrc file created by Conan
+
+build:conan-config --cxxopt=-std=gnu++17
+
+build:conan-config --dynamic_mode=off
+build:conan-config --compilation_mode=opt
+
    +
    +
    +

    The Bazel build helper will use that conan_bzl.rc file to perform a call using this +configuration. The outcoming command will look like this bazel --bazelrc=/path/to/conan_bzl.rc build --config=conan-config <target>.

    +
    +
    +

    Reference

    +
    +
    +class BazelToolchain(conanfile)
    +
    +++ + + + +
    Parameters:conanfile – < ConanFile object > The current recipe object. Always use self.
    +
    +
    +force_pic = None
    +

    Boolean used to add –force_pic=True. Depends on self.options.shared and +self.options.fPIC values

    +
    + +
    +
    +dynamic_mode = None
    +

    String used to add –dynamic_mode=[“fully”|”off”]. Depends on self.options.shared value.

    +
    + +
    +
    +cppstd = None
    +

    String used to add –cppstd=[FLAG]. Depends on your settings.

    +
    + +
    +
    +copt = None
    +

    List of flags used to add –copt=flag1 … –copt=flagN

    +
    + +
    +
    +conlyopt = None
    +

    List of flags used to add –conlyopt=flag1 … –conlyopt=flagN

    +
    + +
    +
    +cxxopt = None
    +

    List of flags used to add –cxxopt=flag1 … –cxxopt=flagN

    +
    + +
    +
    +linkopt = None
    +

    List of flags used to add –linkopt=flag1 … –linkopt=flagN

    +
    + +
    +
    +compilation_mode = None
    +

    String used to add –compilation_mode=[“opt”|”dbg”]. Depends on self.settings.build_type

    +
    + +
    +
    +compiler = None
    +

    String used to add –compiler=xxxx.

    +
    + +
    +
    +cpu = None
    +

    String used to add –cpu=xxxxx. At the moment, it’s only added if cross-building.

    +
    + +
    +
    +crosstool_top = None
    +

    String used to add –crosstool_top.

    +
    + +
    +
    +generate()
    +

    Creates a conan_bzl.rc file with some bazel-build configuration. This last mentioned +is put as conan-config.

    +
    + +
    + +
    +

    conf

    +

    BazelToolchain is affected by these [conf] variables:

    +
      +
    • tools.build:cxxflags list of extra C++ flags that will be used by cxxopt.
      • +
    • tools.build:cflags list of extra of pure C flags that will be used by conlyopt.
      • +
    • tools.build:sharedlinkflags list of extra linker flags that will be used by linkopt.
      • +
    • tools.build:exelinkflags list of extra linker flags that will be used by linkopt.
      • +
    • tools.build:linker_scripts list of linker scripts, each of which will be prefixed with -T and added to linkopt.
      • +
    +
    +
    +
    + + +
    +
    + +
    +
    + + +
    +
    + +
    + +
    + +
    + + + Version: 2.0 + + +
    +
    +
    Versions
    + + +
    2.0
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    2
    + + +
    + + + + +
    1
    + + + +
    1.62
    + + + +
    1.61
    + + + +
    1.60
    + + + +
    1.59
    + + + +
    1.58
    + + + +
    1.57
    + + + +
    1.56
    + + + +
    1.55
    + + + +
    1.54
    + + + +
    1.53
    + + + +
    1.52
    + + + +
    1.51
    + + + +
    1.50
    + + + +
    1.49
    + + + +
    1.48
    + + + +
    1.47
    + + + +
    1.46
    + + + +
    1.45
    + + + +
    1.44
    + + + +
    1.43
    + + + +
    1.42
    + + + +
    1.41
    + + + +
    1.40
    + + + +
    1.39
    + + + +
    1.38
    + + + +
    1.37
    + + + +
    1.36
    + + + +
    1.35
    + + + +
    1.34
    + + + +
    1.33
    + + + +
    1.32
    + + + +
    1.31
    + + + +
    1.30
    + + + +
    1.29
    + + + +
    1.28
    + + + +
    1.27
    + + + +
    1.26
    + + + +
    1.25
    + + + +
    1.24
    + + + +
    1.23
    + + + +
    1.22
    + + + +
    1.21
    + + + +
    1.20
    + + + +
    1.19
    + + + +
    1.18
    + + + +
    1.17
    + + + +
    1.16
    + + + +
    1.15
    + + + +
    1.14
    + + + +
    1.13
    + + + +
    1.12
    + + + +
    1.11
    + + + +
    1.10
    + + + +
    1.9
    + + + +
    1.8
    + + + +
    1.7
    + + + +
    1.6
    + + + +
    1.5
    + + + +
    1.4
    + + + +
    1.3
    + + + + +
    +
    +
    Downloads
    + +
    PDF
    + +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/2.0/reference/tools/intel.html b/2.0/reference/tools/intel.html index b4715ee9997..80ec149f1e4 100644 --- a/2.0/reference/tools/intel.html +++ b/2.0/reference/tools/intel.html @@ -10,7 +10,7 @@ - conan.tools.intel — conan 2.0.13 documentation + conan.tools.intel — conan 2.0.14 documentation @@ -45,10 +45,10 @@ - + - - + + + + + + + + + + + + + + + + + +
    + + + + +
    + + + + + + + +
    +
    + + + + + + + + + + + + + + + + + + + + +
    +
    + +
    +

    Save and restore packages from/to the cache

    +
    +

    Warning

    +

    This feature is experimental and subject to breaking changes. +See the Conan stability section for more information.

    +
    +

    With the conan cache save and conan cache restore commands, it is possible to create a .tgz from one or several packages from a Conan cache and later restore those packages into another Conan cache. There are some scenarios this can be useful:

    +
      +
    • In Continuous Integration, specially if doing distributed builds, it might be very convenient to be able to move temporary packages recently built. Most CI systems have the capability of transferring files between jobs for this purpose. The Conan cache is not concurrent, sometimes for paralllel jobs different caches have to be used.
      • +
    • For air-gapped setups, in which packages can only be transferred via client side.
      • +
    • Developers directly sharing some packages with other developers for testing or inspection.
      • +
    +

    The process of saving the packages is using the conan cache save command. +It can use a pattern, like the conan list command, but it can also accept a package-list, like other commands like remove, upload, download. For example:

    +
    $ conan cache save "pkg/*:*"
+Saving pkg/1.0: p/pkg1df6df1a3b33c
+Saving pkg/1.0:9a4eb3c8701508aa9458b1a73d0633783ecc2270: p/b/pkgd573962ec2c90/p
+Saving pkg/1.0:9a4eb3c8701508aa9458b1a73d0633783ecc2270 metadata: p/b/pkgd573962ec2c90/p
+...
+# creates conan_cache_save.tgz
+
    +
    +

    The conan_cache_save.tgz file contains the packages named pkg (any version), the last recipe revision, and the last package revision of all the package binaries. +The name of the file can be changed with the optional --file=xxxx argument. Some important considerations:

    +
      +
    • The command saves the contents of the cache “recipe” folders, containing the subfolders “export”, “export_sources”, “download”, “source” and recipe “metadata”.
      • +
    • The command saves the contents of the “package” and the package “metadata” folders, but not the binary “build” or “download”, that are considered temporary folders.
      • +
    • If the user doesn’t want any of those folders to be saved, they can be cleaned before saving them with conan cache clean command
      • +
    • The command saves the cache files and artifacts as well as the metadata (revisions, package_id) to be able to restore those packages in another cache. But it doesn’t save any other cache state like settings.yml, global.conf, remotes, etc. If the saved packages require any other specific configuration, it should be managed with conan config install.
      • +
    +

    We can move this conan_cache_save.tgz file to another Conan cache and restore it as:

    +
    $ conan cache restore conan_cache_save.tgz
+Restore: pkg/1.0 in p/pkg1df6df1a3b33c
+Restore: pkg/1.0:9a4eb3c8701508aa9458b1a73d0633783ecc2270 in p/b/pkg773791b8c97aa/p
+Restore: pkg/1.0:9a4eb3c8701508aa9458b1a73d0633783ecc2270 metadata in p/b/pkg773791b8c97aa/d/metadata
+...
+
    +
    +

    The restore process will overwrite existing packages if they already exist in the cache.

    +
    +

    Note

    +

    Best practices

    +
      +
    • Saving and restoring packages is not a substitute for proper storage (upload) of packages in a Conan server repository. +It is only intended as a transitory mechanism, in CI systems, to save an air-gap, etc., but not as a long-term storage +and retrieval.
      • +
    • Saving and restoring packages is not a substitute for proper backup of server repositories. The recommended way to +implement long term backup of Conan packages is using some server side backup strategy.
      • +
    • The storage format and serialization is not guaranteed at this moment to be future-proof and stable. It is expected +to work in the same Conan version, but future Conan versions might break the storage format created with previous versions. +(this is aligned with the above recommendation to not use it as a backup strategy)
      • +
    +
    +
    + + +
    +
    + +
    +
    + + +
    +
    + +
    + +
    + +
    + + + Version: 2.0 + + +
    +
    +
    Versions
    + + +
    2.0
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    2
    + + +
    + + + + +
    1
    + + + +
    1.62
    + + + +
    1.61
    + + + +
    1.60
    + + + +
    1.59
    + + + +
    1.58
    + + + +
    1.57
    + + + +
    1.56
    + + + +
    1.55
    + + + +
    1.54
    + + + +
    1.53
    + + + +
    1.52
    + + + +
    1.51
    + + + +
    1.50
    + + + +
    1.49
    + + + +
    1.48
    + + + +
    1.47
    + + + +
    1.46
    + + + +
    1.45
    + + + +
    1.44
    + + + +
    1.43
    + + + +
    1.42
    + + + +
    1.41
    + + + +
    1.40
    + + + +
    1.39
    + + + +
    1.38
    + + + +
    1.37
    + + + +
    1.36
    + + + +
    1.35
    + + + +
    1.34
    + + + +
    1.33
    + + + +
    1.32
    + + + +
    1.31
    + + + +
    1.30
    + + + +
    1.29
    + + + +
    1.28
    + + + +
    1.27
    + + + +
    1.26
    + + + +
    1.25
    + + + +
    1.24
    + + + +
    1.23
    + + + +
    1.22
    + + + +
    1.21
    + + + +
    1.20
    + + + +
    1.19
    + + + +
    1.18
    + + + +
    1.17
    + + + +
    1.16
    + + + +
    1.15
    + + + +
    1.14
    + + + +
    1.13
    + + + +
    1.12
    + + + +
    1.11
    + + + +
    1.10
    + + + +
    1.9
    + + + +
    1.8
    + + + +
    1.7
    + + + +
    1.6
    + + + +
    1.5
    + + + +
    1.4
    + + + +
    1.3
    + + + + +
    +
    +
    Downloads
    + +
    PDF
    + +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/2/devops/using_conancenter.html b/2/devops/using_conancenter.html index 055f3c8407b..1e4dfae458c 100644 --- a/2/devops/using_conancenter.html +++ b/2/devops/using_conancenter.html @@ -10,7 +10,7 @@ - Using ConanCenter packages in production environments — conan 2.0.13 documentation + Using ConanCenter packages in production environments — conan 2.0.14 documentation @@ -45,7 +45,7 @@ - + @@ -120,6 +120,7 @@
  • Backing up third-party sources with Conan
  • Managing package metadata files
  • Versioning
    • +
  • Save and restore packages from/to the cache
  • Integrations
    • @@ -342,7 +343,7 @@

    Control and customization

    © Copyright 2016-2023, JFrog. - Last updated on Nov 03, 2023. + Last updated on Nov 14, 2023. Cookies Settings

    @@ -487,6 +488,8 @@

    Control and customization1.62 + + +
    1.61
    @@ -755,7 +762,7 @@

    Control and customization var DOCUMENTATION_OPTIONS = { URL_ROOT:'../', - VERSION:'2.0.13', + VERSION:'2.0.14', COLLAPSE_INDEX:false, FILE_SUFFIX:'.html', HAS_SOURCE: true, diff --git a/2/devops/versioning.html b/2/devops/versioning.html index 96365a67b7d..fa96c630e1c 100644 --- a/2/devops/versioning.html +++ b/2/devops/versioning.html @@ -10,7 +10,7 @@ - Versioning — conan 2.0.13 documentation + Versioning — conan 2.0.14 documentation @@ -45,7 +45,7 @@ - + @@ -120,6 +120,7 @@
  • Handling version ranges and pre-releases
    • +
  • Save and restore packages from/to the cache
  • Integrations
    • @@ -240,7 +241,7 @@

    © Copyright 2016-2023, JFrog. - Last updated on Nov 03, 2023. + Last updated on Nov 14, 2023. Cookies Settings

    @@ -385,6 +386,8 @@ + + @@ -401,6 +404,10 @@ +
    1.62
    + + +
    1.61
    @@ -653,7 +660,7 @@ + + + + + + + + + + + + + + + +
    + + + + +
    + + + + + + + +
    +
    + + + + + + + + + + + + + + + + + + + + +
    +
    + + + + +
    +
    + +
    +
    + + +
    +
    + +
    + +
    + +
    + + + Version: 2.0 + + +
    +
    +
    Versions
    + + +
    2.0
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    2
    + + +
    + + + + +
    1
    + + + +
    1.62
    + + + +
    1.61
    + + + +
    1.60
    + + + +
    1.59
    + + + +
    1.58
    + + + +
    1.57
    + + + +
    1.56
    + + + +
    1.55
    + + + +
    1.54
    + + + +
    1.53
    + + + +
    1.52
    + + + +
    1.51
    + + + +
    1.50
    + + + +
    1.49
    + + + +
    1.48
    + + + +
    1.47
    + + + +
    1.46
    + + + +
    1.45
    + + + +
    1.44
    + + + +
    1.43
    + + + +
    1.42
    + + + +
    1.41
    + + + +
    1.40
    + + + +
    1.39
    + + + +
    1.38
    + + + +
    1.37
    + + + +
    1.36
    + + + +
    1.35
    + + + +
    1.34
    + + + +
    1.33
    + + + +
    1.32
    + + + +
    1.31
    + + + +
    1.30
    + + + +
    1.29
    + + + +
    1.28
    + + + +
    1.27
    + + + +
    1.26
    + + + +
    1.25
    + + + +
    1.24
    + + + +
    1.23
    + + + +
    1.22
    + + + +
    1.21
    + + + +
    1.20
    + + + +
    1.19
    + + + +
    1.18
    + + + +
    1.17
    + + + +
    1.16
    + + + +
    1.15
    + + + +
    1.14
    + + + +
    1.13
    + + + +
    1.12
    + + + +
    1.11
    + + + +
    1.10
    + + + +
    1.9
    + + + +
    1.8
    + + + +
    1.7
    + + + +
    1.6
    + + + +
    1.5
    + + + +
    1.4
    + + + +
    1.3
    + + + + +
    +
    +
    Downloads
    + +
    PDF
    + +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/2/reference/tools/google/bazel.html b/2/reference/tools/google/bazel.html new file mode 100644 index 00000000000..0c578f31e1a --- /dev/null +++ b/2/reference/tools/google/bazel.html @@ -0,0 +1,818 @@ + + + + + + + + + + + + + Bazel — conan 2.0.14 documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + +
    + + + + + + + +
    +
    + + + + + + + + + + + + + + + + + + + + +
    +
    + +
    +

    Bazel

    +
    +

    Warning

    +

    This feature is experimental and subject to breaking changes. +See the Conan stability section for more information.

    +
    +

    The Bazel build helper is a wrapper around the command line invocation of bazel. It will abstract the +calls like bazel <rcpaths> build <configs> <targets> into Python method calls.

    +

    The helper is intended to be used in the conanfile.py build() method, to call Bazel commands automatically +when a package is being built directly by Conan (create, install)

    +
    from conan import ConanFile
+from conan.tools.google import Bazel
+
+class App(ConanFile):
+    settings = "os", "arch", "compiler", "build_type"
+
+    def build(self):
+        bz = Bazel(self)
+        bz.build(target="//main:hello-world")
+
    +
    +
    +

    Reference

    +
    +
    +class Bazel(conanfile)
    +
    +++ + + + +
    Parameters:conanfile – < ConanFile object > The current recipe object. Always use self.
    +
    +
    +build(args=None, target='//...', clean=True)
    +

    Runs “bazel <rcpaths> build <configs> <args> <targets>” command where:

    +
      +
    • rcpaths: adds --bazelrc=xxxx per rc-file path. It listens to BazelToolchain +(--bazelrc=conan_bzl.rc), and tools.google.bazel:bazelrc_path conf.
      • +
    • configs: adds --config=xxxx per bazel-build configuration. +It listens to BazelToolchain (--config=conan-config), and +tools.google.bazel:configs conf.
      • +
    • args: they are any extra arguments to add to the bazel build execution.
      • +
    • targets: all the target labels.
      • +
    + +++ + + + +
    Parameters:
      +
    • target – It is the target label. By default, it’s “//…” which runs all the targets.
      • +
    • args – list of extra arguments to pass to the CLI.
      • +
    • clean – boolean that indicates to run a “bazel clean” before running the “bazel build”. +Notice that this is important to ensure a fresh bazel cache every
      • +
    +
    +
    + +
    +
    +test(target=None)
    +

    Runs “bazel test <targets>” command.

    +
    + +
    + +
    +

    Properties

    +

    The following properties affect the Bazel build helper:

    +
      +
    • tools.build:skip_test=<bool> (boolean) if True, it runs the bazel test <target>.
      • +
    +
    +
    +

    conf

    +

    Bazel is affected by these [conf] variables:

    +
      +
    • tools.google.bazel:bazelrc_path: List of paths to other bazelrc files to be used as bazel --bazelrc=rcpath1 ... build.
      • +
    • tools.google.bazel:configs: List of Bazel configurations to be used as bazel build --config=config1 ....
      • +
    +
    +
    +
    + + +
    +
    + +
    +
    + + +
    +
    + +
    + +
    + +
    + + + Version: 2.0 + + +
    +
    +
    Versions
    + + +
    2.0
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    2
    + + +
    + + + + +
    1
    + + + +
    1.62
    + + + +
    1.61
    + + + +
    1.60
    + + + +
    1.59
    + + + +
    1.58
    + + + +
    1.57
    + + + +
    1.56
    + + + +
    1.55
    + + + +
    1.54
    + + + +
    1.53
    + + + +
    1.52
    + + + +
    1.51
    + + + +
    1.50
    + + + +
    1.49
    + + + +
    1.48
    + + + +
    1.47
    + + + +
    1.46
    + + + +
    1.45
    + + + +
    1.44
    + + + +
    1.43
    + + + +
    1.42
    + + + +
    1.41
    + + + +
    1.40
    + + + +
    1.39
    + + + +
    1.38
    + + + +
    1.37
    + + + +
    1.36
    + + + +
    1.35
    + + + +
    1.34
    + + + +
    1.33
    + + + +
    1.32
    + + + +
    1.31
    + + + +
    1.30
    + + + +
    1.29
    + + + +
    1.28
    + + + +
    1.27
    + + + +
    1.26
    + + + +
    1.25
    + + + +
    1.24
    + + + +
    1.23
    + + + +
    1.22
    + + + +
    1.21
    + + + +
    1.20
    + + + +
    1.19
    + + + +
    1.18
    + + + +
    1.17
    + + + +
    1.16
    + + + +
    1.15
    + + + +
    1.14
    + + + +
    1.13
    + + + +
    1.12
    + + + +
    1.11
    + + + +
    1.10
    + + + +
    1.9
    + + + +
    1.8
    + + + +
    1.7
    + + + +
    1.6
    + + + +
    1.5
    + + + +
    1.4
    + + + +
    1.3
    + + + + +
    +
    +
    Downloads
    + +
    PDF
    + +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/2/reference/tools/google/bazeldeps.html b/2/reference/tools/google/bazeldeps.html new file mode 100644 index 00000000000..c672b09680c --- /dev/null +++ b/2/reference/tools/google/bazeldeps.html @@ -0,0 +1,1020 @@ + + + + + + + + + + + + + BazelDeps — conan 2.0.14 documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + +
    + + + + + + + +
    +
    + + + + + + + + + + + + + + + + + + + + +
    +
    + +
    +

    BazelDeps

    +
    +

    Warning

    +

    This feature is experimental and subject to breaking changes. +See the Conan stability section for more information.

    +
    +

    The BazelDeps is the dependencies generator for Bazel. Generates a <REPOSITORY>/BUILD.bazel file per dependency, +where the <REPOSITORY>/ folder is the Conan recipe reference name by default, e.g., mypkg/BUILD.bazel. Apart from +that, it also generates a dependencies.bzl file which contains a Bazel function to load all your Conan dependencies.

    +

    The BazelDeps generator can be used by name in conanfiles:

    +
    +
    conanfile.py
    +
    class Pkg(ConanFile):
+    generators = "BazelDeps"
+
    +
    +
    +
    +
    conanfile.txt
    +
    [generators]
+BazelDeps
+
    +
    +
    +

    And it can also be fully instantiated in the conanfile generate() method:

    +
    from conan import ConanFile
+from conan.tools.google import BazelDeps
+
+class App(ConanFile):
+    settings = "os", "arch", "compiler", "build_type"
+    requires = "zlib/1.2.11"
+
+    def generate(self):
+        bz = BazelDeps(self)
+        bz.generate()
+
    +
    +
    +

    Generated files

    +

    When the BazelDeps generator is used, every invocation of conan install will +generate several bazel files. For the conanfile.py +above, for example:

    +
    $ conan install .
+.
+├── BUILD.bazel
+├── conanfile.py
+├── dependencies.bzl
+└── zlib
+    └── BUILD.bazel
+
    +
    +

    Every conan install generates these files:

    +
      +
    • BUILD.bazel: An empty file aimed to be alongside the dependencies.bzl one. +More information here.
      • +
    • dependencies.bzl: this file tells your Bazel WORKSPACE how to load the dependencies.
      • +
    • zlib/BUILD.bazel: contains all the targets that you can load from any of your BUILD files. More information in +Customization.
      • +
    +

    Let’s check the content of the files created:

    +
    +
    dependencies.bzl
    +
    # This Bazel module should be loaded by your WORKSPACE file.
+# Add these lines to your WORKSPACE one (assuming that you're using the "bazel_layout"):
+# load("@//conan:dependencies.bzl", "load_conan_dependencies")
+# load_conan_dependencies()
+
+def load_conan_dependencies():
+    native.new_local_repository(
+        name="zlib",
+        path="/path/to/conan/package/folder/",
+        build_file="/your/current/working/directory/zlib/BUILD.bazel",
+    )
+
    +
    +
    +

    Given the example above, and imagining that your WORKSPACE is at the same directory, you would have to add these lines in there:

    +
    +
    WORKSPACE
    +
    load("@//:dependencies.bzl", "load_conan_dependencies")
+load_conan_dependencies()
+
    +
    +
    +
    +
    zlib/BUILD.bazel
    +
    load("@rules_cc//cc:defs.bzl", "cc_import", "cc_library")
+
+# Components precompiled libs
+# Root package precompiled libs
+cc_import(
+    name = "z_precompiled",
+    static_library = "lib/libz.a",
+)
+
+# Components libraries declaration
+# Package library declaration
+cc_library(
+    name = "zlib",
+    hdrs = glob([
+        "include/**",
+    ]),
+    includes = [
+        "include",
+    ],
+    visibility = ["//visibility:public"],
+    deps = [
+        ":z_precompiled",
+    ],
+)
+
+# Filegroup library declaration
+filegroup(
+    name = "zlib_binaries",
+    srcs = glob([
+        "bin/**",
+    ]),
+    visibility = ["//visibility:public"],
+)
+
    +
    +
    +

    As you can observe, the zlib/BUILD.bazel defines these global targets:

    +
      +
    • zlib: bazel library target. The label used to depend on it would be @zlib//:zlib.
      • +
    • zlib_binaries: bazel filegroup target. The label used to depend on it would be @zlib//:zlib_binaries.
      • +
    +

    You can put all the files generated by BazelDeps into another folder using the bazel_layout:

    +
    +
    conanfile.py
    +
    from conan import ConanFile
+from conan.tools.google import BazelDeps, bazel_layout
+
+class App(ConanFile):
+    settings = "os", "arch", "compiler", "build_type"
+    requires = "zlib/1.2.11"
+
+    def layout(self):
+        bazel_layout(self)
+
+    def generate(self):
+        bz = BazelDeps(self)
+        bz.generate()
+
    +
    +
    +

    Running again the conan install command, we now get this structure:

    +
    $ conan install .
+.
+├── conan
+│   ├── BUILD.bazel
+│   ├── dependencies.bzl
+│   └── zlib
+│       └── BUILD.bazel
+└── conanfile.py
+
    +
    +

    Now your Conan-bazel files were generated in the conan/ folder, so your WORKSPACE will look like:

    +
    +
    WORKSPACE
    +
    load("@//conan:dependencies.bzl", "load_conan_dependencies")
+load_conan_dependencies()
+
    +
    +
    +
    +
    +

    Customization

    +
    +

    Naming

    +

    The <REPOSITORY>/BUILD.bazel file contains all the targets declared by the dependency. Both the <REPOSITORY>/ folder and the targets +declared in there will be named following these rules by default:

    +
      +
    • +
      For packages, it uses the package name as folder/target name, e.g., package zlib/1.2.11 will have:
      +
        +
      • Folder: zlib/BUILD.bazel.
        • +
      • Global target: zlib.
        • +
      • How it can be consumed: @zlib//:zlib.
        • +
      +
      +
      +
      • +
    • +
      For components, the package name + hyphen + component name, e.g., package openssl/3.1.4 will have:
      +
        +
      • Folder: openssl/BUILD.bazel.
        • +
      • Global target: openssl.
        • +
      • Components targets: openssl-ssl, and openssl-crypto.
        • +
      • +
        How it can be consumed:
        +
          +
        • @openssl//:openssl (global one which includes all the components)
          • +
        • @openssl//:openssl-ssl (component one)
          • +
        • @openssl//:openssl-crypto (component one)
          • +
        +
        +
        +
        • +
      +
      +
      +
      • +
    +

    You can change that default behavior with the bazel_target_name and the bazel_repository_name properties. +See Properties section below.

    +
    +
    +
    +

    Reference

    +
    +
    +class BazelDeps(conanfile)
    +
    +++ + + + +
    Parameters:conanfile – < ConanFile object > The current recipe object. Always use self.
    +
    +
    +build_context_activated = None
    +

    Activates the build context for the specified Conan package names.

    +
    + +
    +
    +generate()
    +

    Generates all the targets <DEP>/BUILD.bazel files and the dependencies.bzl one in the +build folder. It’s important to highlight that the dependencies.bzl file should be loaded +by your WORKSPACE Bazel file:

    +
    load("@//[BUILD_FOLDER]:dependencies.bzl", "load_conan_dependencies")
+load_conan_dependencies()
+
    +
    +
    + +
    + +
    +

    build_context_activated

    +

    When you have a build-requirement, by default, the Bazel files are not generated. +But you can activate it using the build_context_activated attribute:

    +
    def build_requirements(self):
+    self.tool_requires("my_tool/0.0.1")
+
+def layout(self):
+    bazel_layout(self)
+
+def generate(self):
+    bz = BazelDeps(self)
+    # generate the build-mytool/BUILD.bazel file for the tool require
+    bz.build_context_activated = ["my_tool"]
+    bz.generate()
+
    +
    +

    Running the conan install command, the structure created is as follows:

    +
    $ conan install . -pr:b default
+.
+├── conan
+│   ├── BUILD.bazel
+│   ├── build-my_tool
+│   │   └── BUILD.bazel
+│   └── dependencies.bzl
+└── conanfile.py
+
    +
    +

    Notice that my_tool Bazel folder is prefixed with build- which indicates that it’s being used in the build context.

    +
    +
    +

    Properties

    +

    The following properties affect the BazelDeps generator:

    +
      +
    • bazel_target_name property will define the name of the target declared in the <REPOSITORY>/BUILD.bazel. +This property can be defined at both global and component cpp_info level.
      • +
    • bazel_repository_name property will define the name of the folder where the dependency BUILD.bazel will be +allocated. This property can only be defined at global cpp_info level.
      • +
    +

    Example:

    +
    def package_info(self):
+    self.cpp_info.set_property("bazel_target_name", "my_target")
+    self.cpp_info.set_property("bazel_repository_name", "my_repo")
+    self.cpp_info.components["mycomponent"].set_property("bazel_target_name", "component_name")
+
    +
    +
    +
    +
    + + +
    +
    + +
    +
    + + +
    +
    + +
    + +
    + +
    + + + Version: 2.0 + + +
    +
    +
    Versions
    + + +
    2.0
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    2
    + + +
    + + + + +
    1
    + + + +
    1.62
    + + + +
    1.61
    + + + +
    1.60
    + + + +
    1.59
    + + + +
    1.58
    + + + +
    1.57
    + + + +
    1.56
    + + + +
    1.55
    + + + +
    1.54
    + + + +
    1.53
    + + + +
    1.52
    + + + +
    1.51
    + + + +
    1.50
    + + + +
    1.49
    + + + +
    1.48
    + + + +
    1.47
    + + + +
    1.46
    + + + +
    1.45
    + + + +
    1.44
    + + + +
    1.43
    + + + +
    1.42
    + + + +
    1.41
    + + + +
    1.40
    + + + +
    1.39
    + + + +
    1.38
    + + + +
    1.37
    + + + +
    1.36
    + + + +
    1.35
    + + + +
    1.34
    + + + +
    1.33
    + + + +
    1.32
    + + + +
    1.31
    + + + +
    1.30
    + + + +
    1.29
    + + + +
    1.28
    + + + +
    1.27
    + + + +
    1.26
    + + + +
    1.25
    + + + +
    1.24
    + + + +
    1.23
    + + + +
    1.22
    + + + +
    1.21
    + + + +
    1.20
    + + + +
    1.19
    + + + +
    1.18
    + + + +
    1.17
    + + + +
    1.16
    + + + +
    1.15
    + + + +
    1.14
    + + + +
    1.13
    + + + +
    1.12
    + + + +
    1.11
    + + + +
    1.10
    + + + +
    1.9
    + + + +
    1.8
    + + + +
    1.7
    + + + +
    1.6
    + + + +
    1.5
    + + + +
    1.4
    + + + +
    1.3
    + + + + +
    +
    +
    Downloads
    + +
    PDF
    + +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/2/reference/tools/google/bazeltoolchain.html b/2/reference/tools/google/bazeltoolchain.html new file mode 100644 index 00000000000..1452aa2f0f6 --- /dev/null +++ b/2/reference/tools/google/bazeltoolchain.html @@ -0,0 +1,888 @@ + + + + + + + + + + + + + BazelToolchain — conan 2.0.14 documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + +
    + + + + + + + +
    +
    + + + + + + + + + + + + + + + + + + + + +
    +
    + +
    +

    BazelToolchain

    +
    +

    Warning

    +

    This feature is experimental and subject to breaking changes. +See the Conan stability section for more information.

    +
    +

    The BazelToolchain is the toolchain generator for Bazel. It will generate a conan_bzl.rc file that contains +a build configuration conan-config to inject all the parameters into the bazel build command.

    +

    The BazelToolchain generator can be used by name in conanfiles:

    +
    +
    conanfile.py
    +
    class Pkg(ConanFile):
+    generators = "BazelToolchain"
+
    +
    +
    +
    +
    conanfile.txt
    +
    [generators]
+BazelToolchain
+
    +
    +
    +

    And it can also be fully instantiated in the conanfile generate() method:

    +
    +
    conanfile.py
    +
    from conan import ConanFile
+from conan.tools.google import BazelToolchain
+
+class App(ConanFile):
+    settings = "os", "arch", "compiler", "build_type"
+
+    def generate(self):
+        tc = BazelToolchain(self)
+        tc.generate()
+
    +
    +
    +
    +

    Generated files

    +

    After running conan install command, the BazelToolchain generates the conan_bzl.rc file +that contains Bazel build parameters (it will depend on your current Conan settings and options from your default profile):

    +
    +
    conan_bzl.rc
    +
    # Automatic bazelrc file created by Conan
+
+build:conan-config --cxxopt=-std=gnu++17
+
+build:conan-config --dynamic_mode=off
+build:conan-config --compilation_mode=opt
+
    +
    +
    +

    The Bazel build helper will use that conan_bzl.rc file to perform a call using this +configuration. The outcoming command will look like this bazel --bazelrc=/path/to/conan_bzl.rc build --config=conan-config <target>.

    +
    +
    +

    Reference

    +
    +
    +class BazelToolchain(conanfile)
    +
    +++ + + + +
    Parameters:conanfile – < ConanFile object > The current recipe object. Always use self.
    +
    +
    +force_pic = None
    +

    Boolean used to add –force_pic=True. Depends on self.options.shared and +self.options.fPIC values

    +
    + +
    +
    +dynamic_mode = None
    +

    String used to add –dynamic_mode=[“fully”|”off”]. Depends on self.options.shared value.

    +
    + +
    +
    +cppstd = None
    +

    String used to add –cppstd=[FLAG]. Depends on your settings.

    +
    + +
    +
    +copt = None
    +

    List of flags used to add –copt=flag1 … –copt=flagN

    +
    + +
    +
    +conlyopt = None
    +

    List of flags used to add –conlyopt=flag1 … –conlyopt=flagN

    +
    + +
    +
    +cxxopt = None
    +

    List of flags used to add –cxxopt=flag1 … –cxxopt=flagN

    +
    + +
    +
    +linkopt = None
    +

    List of flags used to add –linkopt=flag1 … –linkopt=flagN

    +
    + +
    +
    +compilation_mode = None
    +

    String used to add –compilation_mode=[“opt”|”dbg”]. Depends on self.settings.build_type

    +
    + +
    +
    +compiler = None
    +

    String used to add –compiler=xxxx.

    +
    + +
    +
    +cpu = None
    +

    String used to add –cpu=xxxxx. At the moment, it’s only added if cross-building.

    +
    + +
    +
    +crosstool_top = None
    +

    String used to add –crosstool_top.

    +
    + +
    +
    +generate()
    +

    Creates a conan_bzl.rc file with some bazel-build configuration. This last mentioned +is put as conan-config.

    +
    + +
    + +
    +

    conf

    +

    BazelToolchain is affected by these [conf] variables:

    +
      +
    • tools.build:cxxflags list of extra C++ flags that will be used by cxxopt.
      • +
    • tools.build:cflags list of extra of pure C flags that will be used by conlyopt.
      • +
    • tools.build:sharedlinkflags list of extra linker flags that will be used by linkopt.
      • +
    • tools.build:exelinkflags list of extra linker flags that will be used by linkopt.
      • +
    • tools.build:linker_scripts list of linker scripts, each of which will be prefixed with -T and added to linkopt.
      • +
    +
    +
    +
    + + +
    +
    + +
    +
    + + +
    +
    + +
    + +
    + +
    + + + Version: 2.0 + + +
    +
    +
    Versions
    + + +
    2.0
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    2
    + + +
    + + + + +
    1
    + + + +
    1.62
    + + + +
    1.61
    + + + +
    1.60
    + + + +
    1.59
    + + + +
    1.58
    + + + +
    1.57
    + + + +
    1.56
    + + + +
    1.55
    + + + +
    1.54
    + + + +
    1.53
    + + + +
    1.52
    + + + +
    1.51
    + + + +
    1.50
    + + + +
    1.49
    + + + +
    1.48
    + + + +
    1.47
    + + + +
    1.46
    + + + +
    1.45
    + + + +
    1.44
    + + + +
    1.43
    + + + +
    1.42
    + + + +
    1.41
    + + + +
    1.40
    + + + +
    1.39
    + + + +
    1.38
    + + + +
    1.37
    + + + +
    1.36
    + + + +
    1.35
    + + + +
    1.34
    + + + +
    1.33
    + + + +
    1.32
    + + + +
    1.31
    + + + +
    1.30
    + + + +
    1.29
    + + + +
    1.28
    + + + +
    1.27
    + + + +
    1.26
    + + + +
    1.25
    + + + +
    1.24
    + + + +
    1.23
    + + + +
    1.22
    + + + +
    1.21
    + + + +
    1.20
    + + + +
    1.19
    + + + +
    1.18
    + + + +
    1.17
    + + + +
    1.16
    + + + +
    1.15
    + + + +
    1.14
    + + + +
    1.13
    + + + +
    1.12
    + + + +
    1.11
    + + + +
    1.10
    + + + +
    1.9
    + + + +
    1.8
    + + + +
    1.7
    + + + +
    1.6
    + + + +
    1.5
    + + + +
    1.4
    + + + +
    1.3
    + + + + +
    +
    +
    Downloads
    + +
    PDF
    + +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/2/reference/tools/intel.html b/2/reference/tools/intel.html index b4715ee9997..80ec149f1e4 100644 --- a/2/reference/tools/intel.html +++ b/2/reference/tools/intel.html @@ -10,7 +10,7 @@ - conan.tools.intel — conan 2.0.13 documentation + conan.tools.intel — conan 2.0.14 documentation @@ -45,10 +45,10 @@ - + - - + +