bazel
/
rules_foreign_cc
mirror of https://github.com/bazel-contrib/rules_foreign_cc
2
0
Fork 0
Code Issues Releases Activity
rules_foreign_cc/examples
History
jheaff1 776f199f5d
Add log4cxx example to CI (#762) 
Co-authored-by: UebelAndre <github@uebelandre.com>
 		2021-08-18 06:00:17 -07:00
..
cmake_android Restructured rules to match architecture (#555) 2021-03-12 16:54:14 +00:00
cmake_crosstool Renamed a BUILD file (#662) 2021-06-04 06:50:52 -07:00
cmake_defines Fix quoting for cmake (#703) 2021-07-28 18:12:53 +01:00
cmake_hello_world_lib Enable more examples tests on windows (#718) 2021-07-14 09:37:35 -07:00
cmake_synthetic Add missing includes for std::runtime_error (#728) 2021-07-19 18:40:31 +00:00
cmake_with_bazel_transitive Add missing includes for std::runtime_error (#728) 2021-07-19 18:40:31 +00:00
cmake_with_data Add missing includes for std::runtime_error (#728) 2021-07-19 18:40:31 +00:00
cmake_with_target Ran buildifier (#581) 2021-03-22 08:13:48 -07:00
cmake_working_dir Add missing includes for std::runtime_error (#728) 2021-07-19 18:40:31 +00:00
configure_with_bazel_transitive Wrap tool paths that contain whitespaces in quotes (#732) 2021-07-20 16:44:33 +00:00
deps Set CMAKE_INSTALL_PREFIX to the actual install directory to avoid copy (#575) 2021-03-26 19:31:07 +00:00
make_simple Re-add setting of PREFIX variable in make invocation (#751) 2021-08-03 06:11:07 -07:00
ninja_simple Enable more examples tests on windows (#718) 2021-07-14 09:37:35 -07:00
third_party Add log4cxx example to CI (#762) 2021-08-18 06:00:17 -07:00
.bazelignore Moved `configure_use_malloc` example to third party examples (#634) 2021-05-21 09:06:59 -07:00
BUILD.bazel Move more example build config into example BUILD files (#763) 2021-08-17 14:05:12 +00:00
README.md Added architecture documentation (#544) 2021-03-09 10:49:13 -08:00
WORKSPACE.bazel Fix RBE by using updated bazel-toolchains version (#654) 2021-05-21 19:40:34 +01:00

README.md

Rules Foreign CC Examples

Top-Level

Top-level examples should contain no dependencies outside of rules_foreign_cc directly and anything else in it's directory. The directories should be prefixed with the type of rule they're associated with. Eg cmake_with_data (being a cmake_external example) and configure_with_bazel_transitive (being a configure_make example).

Third Party

Examples of building source from outside of rules_foreign_cc should be put in the third_party directory which is an isolated workspace that gets added to rules_foreign_cc_examples as an additional rules_foreign_cc_examples_third_party repository. In general, these are expected to be expensive to build so adding new things here should be done selectively. In the top-level package of this workspace, there are test suites separated by the operating system that all tests need to be registered with. The expected structure of any example in this workspace are as follows:

third_party/lib
├── BUILD.bazel
├── BUILD.lib.bazel
└── lib_repositories.bzl

BUILD.bazel

This file must contain some sort of test that confirms the targets for the external repo can be successfully built and ideally ran. The targets here will need to be registered in the test_suite's found in ./third_party/BUILD.bazel or they will not be ran in CI.

BUILD.lib.bazel

The BUILD file expected to be used in the repository containing the target source code.

lib_repositories.bzl

A file containing a single macro lib_repositories that should define the desired repository and ensure the BUILD.lib.bazel file will correctly be installed when the repository is setup. This macro will need to be loaded and called in third_party/repositories.bzl.