blob: ae3ea549ac66cf8f0c6d0917f2b66f94459e1c54 [file] [log] [blame]
Philipp Schrader15b92e02020-11-08 10:35:57 -08001load("@//tools/build_rules:select.bzl", "compiler_select")
2
Brian Silverman9c614bc2016-02-15 20:20:02 -05003def _GetPath(ctx, path):
Austin Schuhf9724442018-10-28 20:30:21 -07004 if ctx.label.workspace_root:
5 return ctx.label.workspace_root + '/' + path
6 else:
7 return path
8
9def _IsNewExternal(ctx):
10 # Bazel 0.4.4 and older have genfiles paths that look like:
11 # bazel-out/local-fastbuild/genfiles/external/repo/foo
12 # After the exec root rearrangement, they look like:
13 # ../repo/bazel-out/local-fastbuild/genfiles/foo
14 return ctx.label.workspace_root.startswith("../")
Brian Silverman9c614bc2016-02-15 20:20:02 -050015
16def _GenDir(ctx):
Austin Schuhf9724442018-10-28 20:30:21 -070017 if _IsNewExternal(ctx):
18 # We are using the fact that Bazel 0.4.4+ provides repository-relative paths
19 # for ctx.genfiles_dir.
20 return ctx.genfiles_dir.path + (
21 "/" + ctx.attr.includes[0] if ctx.attr.includes and ctx.attr.includes[0] else "")
22 # This means that we're either in the old version OR the new version in the local repo.
23 # Either way, appending the source path to the genfiles dir works.
24 return ctx.var["GENDIR"] + "/" + _SourceDir(ctx)
25
26def _SourceDir(ctx):
Brian Silverman9c614bc2016-02-15 20:20:02 -050027 if not ctx.attr.includes:
Austin Schuhf9724442018-10-28 20:30:21 -070028 return ctx.label.workspace_root
Brian Silverman9c614bc2016-02-15 20:20:02 -050029 if not ctx.attr.includes[0]:
30 return _GetPath(ctx, ctx.label.package)
31 if not ctx.label.package:
32 return _GetPath(ctx, ctx.attr.includes[0])
33 return _GetPath(ctx, ctx.label.package + '/' + ctx.attr.includes[0])
34
Austin Schuhf9724442018-10-28 20:30:21 -070035def _CcHdrs(srcs, use_grpc_plugin=False):
36 ret = [s[:-len(".proto")] + ".pb.h" for s in srcs]
37 if use_grpc_plugin:
38 ret += [s[:-len(".proto")] + ".grpc.pb.h" for s in srcs]
39 return ret
Brian Silverman9c614bc2016-02-15 20:20:02 -050040
Austin Schuhf9724442018-10-28 20:30:21 -070041def _CcSrcs(srcs, use_grpc_plugin=False):
42 ret = [s[:-len(".proto")] + ".pb.cc" for s in srcs]
43 if use_grpc_plugin:
44 ret += [s[:-len(".proto")] + ".grpc.pb.cc" for s in srcs]
45 return ret
Brian Silverman9c614bc2016-02-15 20:20:02 -050046
Austin Schuhf9724442018-10-28 20:30:21 -070047def _CcOuts(srcs, use_grpc_plugin=False):
48 return _CcHdrs(srcs, use_grpc_plugin) + _CcSrcs(srcs, use_grpc_plugin)
49
50def _PyOuts(srcs, use_grpc_plugin=False):
51 ret = [s[:-len(".proto")] + "_pb2.py" for s in srcs]
52 if use_grpc_plugin:
53 ret += [s[:-len(".proto")] + "_pb2_grpc.py" for s in srcs]
54 return ret
55
56def _RelativeOutputPath(path, include, dest=""):
Brian Silverman9c614bc2016-02-15 20:20:02 -050057 if include == None:
58 return path
59
60 if not path.startswith(include):
61 fail("Include path %s isn't part of the path %s." % (include, path))
62
63 if include and include[-1] != '/':
64 include = include + '/'
Austin Schuhf9724442018-10-28 20:30:21 -070065 if dest and dest[-1] != '/':
66 dest = dest + '/'
Brian Silverman9c614bc2016-02-15 20:20:02 -050067
68 path = path[len(include):]
Austin Schuhf9724442018-10-28 20:30:21 -070069 return dest + path
Brian Silverman9c614bc2016-02-15 20:20:02 -050070
71def _proto_gen_impl(ctx):
72 """General implementation for generating protos"""
73 srcs = ctx.files.srcs
74 deps = []
75 deps += ctx.files.srcs
Austin Schuhf9724442018-10-28 20:30:21 -070076 source_dir = _SourceDir(ctx)
Brian Silverman9c614bc2016-02-15 20:20:02 -050077 gen_dir = _GenDir(ctx)
Austin Schuhf9724442018-10-28 20:30:21 -070078 if source_dir:
79 import_flags = ["-I" + source_dir, "-I" + gen_dir]
Brian Silverman9c614bc2016-02-15 20:20:02 -050080 else:
81 import_flags = ["-I."]
82
83 for dep in ctx.attr.deps:
84 import_flags += dep.proto.import_flags
85 deps += dep.proto.deps
86
87 args = []
88 if ctx.attr.gen_cc:
Austin Schuhf9724442018-10-28 20:30:21 -070089 args += ["--cpp_out=" + gen_dir]
Brian Silverman9c614bc2016-02-15 20:20:02 -050090 if ctx.attr.gen_py:
Austin Schuhf9724442018-10-28 20:30:21 -070091 args += ["--python_out=" + gen_dir]
92
93 inputs = srcs + deps
94 if ctx.executable.plugin:
95 plugin = ctx.executable.plugin
96 lang = ctx.attr.plugin_language
97 if not lang and plugin.basename.startswith('protoc-gen-'):
98 lang = plugin.basename[len('protoc-gen-'):]
99 if not lang:
100 fail("cannot infer the target language of plugin", "plugin_language")
101
102 outdir = gen_dir
103 if ctx.attr.plugin_options:
104 outdir = ",".join(ctx.attr.plugin_options) + ":" + outdir
105 args += ["--plugin=protoc-gen-%s=%s" % (lang, plugin.path)]
106 args += ["--%s_out=%s" % (lang, outdir)]
107 inputs += [plugin]
Brian Silverman9c614bc2016-02-15 20:20:02 -0500108
109 if args:
Philipp Schrader5dd9eda2020-11-08 10:16:35 -0800110 ctx.actions.run(
Austin Schuhf9724442018-10-28 20:30:21 -0700111 inputs=inputs,
Brian Silverman9c614bc2016-02-15 20:20:02 -0500112 outputs=ctx.outputs.outs,
113 arguments=args + import_flags + [s.path for s in srcs],
114 executable=ctx.executable.protoc,
Austin Schuhf9724442018-10-28 20:30:21 -0700115 mnemonic="ProtoCompile",
116 use_default_shell_env=True,
Brian Silverman9c614bc2016-02-15 20:20:02 -0500117 )
118
119 return struct(
120 proto=struct(
121 srcs=srcs,
122 import_flags=import_flags,
123 deps=deps,
124 ),
125 )
126
Austin Schuhf9724442018-10-28 20:30:21 -0700127proto_gen = rule(
Brian Silverman9c614bc2016-02-15 20:20:02 -0500128 attrs = {
129 "srcs": attr.label_list(allow_files = True),
130 "deps": attr.label_list(providers = ["proto"]),
131 "includes": attr.string_list(),
132 "protoc": attr.label(
Brian Silverman7b8899e2018-06-30 19:19:24 -0700133 cfg = "host",
Brian Silverman9c614bc2016-02-15 20:20:02 -0500134 executable = True,
Philipp Schrader5dd9eda2020-11-08 10:16:35 -0800135 allow_single_file = True,
Brian Silverman9c614bc2016-02-15 20:20:02 -0500136 mandatory = True,
137 ),
Austin Schuhf9724442018-10-28 20:30:21 -0700138 "plugin": attr.label(
139 cfg = "host",
140 allow_files = True,
141 executable = True,
142 ),
143 "plugin_language": attr.string(),
144 "plugin_options": attr.string_list(),
Brian Silverman9c614bc2016-02-15 20:20:02 -0500145 "gen_cc": attr.bool(),
146 "gen_py": attr.bool(),
147 "outs": attr.output_list(),
148 },
149 output_to_genfiles = True,
150 implementation = _proto_gen_impl,
151)
Austin Schuhf9724442018-10-28 20:30:21 -0700152"""Generates codes from Protocol Buffers definitions.
153
154This rule helps you to implement Skylark macros specific to the target
155language. You should prefer more specific `cc_proto_library `,
156`py_proto_library` and others unless you are adding such wrapper macros.
157
158Args:
159 srcs: Protocol Buffers definition files (.proto) to run the protocol compiler
160 against.
161 deps: a list of dependency labels; must be other proto libraries.
162 includes: a list of include paths to .proto files.
163 protoc: the label of the protocol compiler to generate the sources.
164 plugin: the label of the protocol compiler plugin to be passed to the protocol
165 compiler.
166 plugin_language: the language of the generated sources
167 plugin_options: a list of options to be passed to the plugin
168 gen_cc: generates C++ sources in addition to the ones from the plugin.
169 gen_py: generates Python sources in addition to the ones from the plugin.
170 outs: a list of labels of the expected outputs from the protocol compiler.
171"""
172
173MSVC_COPTS = [
174 "/DHAVE_PTHREAD",
175 "/wd4018", # -Wno-sign-compare
176 "/wd4514", # -Wno-unused-function
177]
178
Austin Schuhf9724442018-10-28 20:30:21 -0700179COPTS = [
180 "-DHAVE_PTHREAD",
181 "-DGOOGLE_THIRD_PARTY_PROTOBUF",
182 "-Wall",
183 "-Wwrite-strings",
184 "-Woverloaded-virtual",
185 "-Wno-sign-compare",
186 "-Wno-unused-function",
187 "-Wno-unused-parameter",
188 "-Wno-format-nonliteral",
189 "-Wno-switch-enum",
190 "-Wno-missing-field-initializers",
191 "-Wno-ignored-qualifiers",
192 ] + compiler_select({
193 "gcc": [
194 "-Wno-error=cast-align",
195 ],
196 "clang": [
197 "-Wno-unused-const-variable",
198 "-Wno-unused-private-field",
199 ],
200 })
Brian Silverman9c614bc2016-02-15 20:20:02 -0500201
202def cc_proto_library(
203 name,
204 srcs=[],
205 deps=[],
206 cc_libs=[],
207 include=None,
Austin Schuhf9724442018-10-28 20:30:21 -0700208 protoc="@com_google_protobuf//:protoc",
Brian Silverman9c614bc2016-02-15 20:20:02 -0500209 internal_bootstrap_hack=False,
Austin Schuhf9724442018-10-28 20:30:21 -0700210 use_grpc_plugin=False,
211 default_runtime="@com_google_protobuf//:protobuf",
Philipp Schraderdada1072020-11-24 11:34:46 -0800212 target_compatible_with = None,
Austin Schuhf9724442018-10-28 20:30:21 -0700213 copts = [],
Brian Silverman9c614bc2016-02-15 20:20:02 -0500214 **kargs):
215 """Bazel rule to create a C++ protobuf library from proto source files
216
217 NOTE: the rule is only an internal workaround to generate protos. The
218 interface may change and the rule may be removed when bazel has introduced
219 the native rule.
220
221 Args:
222 name: the name of the cc_proto_library.
223 srcs: the .proto files of the cc_proto_library.
224 deps: a list of dependency labels; must be cc_proto_library.
225 cc_libs: a list of other cc_library targets depended by the generated
226 cc_library.
227 include: a string indicating the include path of the .proto files.
228 protoc: the label of the protocol compiler to generate the sources.
229 internal_bootstrap_hack: a flag indicate the cc_proto_library is used only
230 for bootstraping. When it is set to True, no files will be generated.
231 The rule will simply be a provider for .proto files, so that other
232 cc_proto_library can depend on it.
Austin Schuhf9724442018-10-28 20:30:21 -0700233 use_grpc_plugin: a flag to indicate whether to call the grpc C++ plugin
234 when processing the proto files.
Brian Silverman9c614bc2016-02-15 20:20:02 -0500235 default_runtime: the implicitly default runtime which will be depended on by
236 the generated cc_library target.
237 **kargs: other keyword arguments that are passed to cc_library.
238
239 """
240
241 includes = []
242 if include != None:
243 includes = [include]
244
245 if internal_bootstrap_hack:
246 # For pre-checked-in generated files, we add the internal_bootstrap_hack
247 # which will skip the codegen action.
Austin Schuhf9724442018-10-28 20:30:21 -0700248 proto_gen(
Brian Silverman9c614bc2016-02-15 20:20:02 -0500249 name=name + "_genproto",
250 srcs=srcs,
251 deps=[s + "_genproto" for s in deps],
252 includes=includes,
253 protoc=protoc,
254 visibility=["//visibility:public"],
255 )
256 # An empty cc_library to make rule dependency consistent.
257 native.cc_library(
258 name=name,
259 **kargs)
260 return
261
Austin Schuhf9724442018-10-28 20:30:21 -0700262 grpc_cpp_plugin = None
263 if use_grpc_plugin:
264 grpc_cpp_plugin = "//external:grpc_cpp_plugin"
265
266 gen_srcs = _CcSrcs(srcs, use_grpc_plugin)
267 gen_hdrs = _CcHdrs(srcs, use_grpc_plugin)
268 outs = gen_srcs + gen_hdrs
269
270 proto_gen(
Brian Silverman9c614bc2016-02-15 20:20:02 -0500271 name=name + "_genproto",
272 srcs=srcs,
273 deps=[s + "_genproto" for s in deps],
274 includes=includes,
275 protoc=protoc,
Austin Schuhf9724442018-10-28 20:30:21 -0700276 plugin=grpc_cpp_plugin,
277 plugin_language="grpc",
Brian Silverman9c614bc2016-02-15 20:20:02 -0500278 gen_cc=1,
279 outs=outs,
Philipp Schraderdada1072020-11-24 11:34:46 -0800280 target_compatible_with = target_compatible_with,
Brian Silverman9c614bc2016-02-15 20:20:02 -0500281 visibility=["//visibility:public"],
282 )
283
284 if default_runtime and not default_runtime in cc_libs:
Austin Schuhbe8c9b12017-11-25 15:53:12 -0800285 cc_libs = cc_libs + [default_runtime]
Austin Schuhf9724442018-10-28 20:30:21 -0700286 if use_grpc_plugin:
287 cc_libs = cc_libs + ["//external:grpc_lib"]
Brian Silverman9c614bc2016-02-15 20:20:02 -0500288
289 native.cc_library(
290 name=name,
Austin Schuhf9724442018-10-28 20:30:21 -0700291 srcs=gen_srcs,
292 hdrs=gen_hdrs,
Brian Silverman9c614bc2016-02-15 20:20:02 -0500293 deps=cc_libs + deps,
294 includes=includes,
Austin Schuhf9724442018-10-28 20:30:21 -0700295 copts = COPTS + copts,
Philipp Schraderdada1072020-11-24 11:34:46 -0800296 target_compatible_with = target_compatible_with,
Brian Silverman9c614bc2016-02-15 20:20:02 -0500297 **kargs)
298
Austin Schuhf9724442018-10-28 20:30:21 -0700299def internal_gen_well_known_protos_java(srcs):
300 """Bazel rule to generate the gen_well_known_protos_java genrule
Brian Silverman9c614bc2016-02-15 20:20:02 -0500301
302 Args:
Austin Schuhf9724442018-10-28 20:30:21 -0700303 srcs: the well known protos
Brian Silverman9c614bc2016-02-15 20:20:02 -0500304 """
Philipp Schrader15b92e02020-11-08 10:35:57 -0800305 root = Label("%s//protobuf_java" % (native.repository_name())).workspace_root
306 pkg = native.package_name() + "/" if native.package_name() else ""
Austin Schuhf9724442018-10-28 20:30:21 -0700307 if root == "":
308 include = " -I%ssrc " % pkg
309 else:
310 include = " -I%s/%ssrc " % (root, pkg)
311 native.genrule(
312 name = "gen_well_known_protos_java",
313 srcs = srcs,
314 outs = [
315 "wellknown.srcjar",
316 ],
317 cmd = "$(location :protoc) --java_out=$(@D)/wellknown.jar" +
318 " %s $(SRCS) " % include +
319 " && mv $(@D)/wellknown.jar $(@D)/wellknown.srcjar",
320 tools = [":protoc"],
321 )
322
323def internal_copied_filegroup(name, srcs, strip_prefix, dest, **kwargs):
324 """Macro to copy files to a different directory and then create a filegroup.
325
326 This is used by the //:protobuf_python py_proto_library target to work around
327 an issue caused by Python source files that are part of the same Python
328 package being in separate directories.
329
330 Args:
331 srcs: The source files to copy and add to the filegroup.
332 strip_prefix: Path to the root of the files to copy.
333 dest: The directory to copy the source files into.
334 **kwargs: extra arguments that will be passesd to the filegroup.
335 """
336 outs = [_RelativeOutputPath(s, strip_prefix, dest) for s in srcs]
Brian Silverman9c614bc2016-02-15 20:20:02 -0500337
338 native.genrule(
Austin Schuhf9724442018-10-28 20:30:21 -0700339 name = name + "_genrule",
340 srcs = srcs,
341 outs = outs,
342 cmd = " && ".join(
343 ["cp $(location %s) $(location %s)" %
344 (s, _RelativeOutputPath(s, strip_prefix, dest)) for s in srcs]),
345 )
Brian Silverman9c614bc2016-02-15 20:20:02 -0500346
347 native.filegroup(
Austin Schuhf9724442018-10-28 20:30:21 -0700348 name = name,
349 srcs = outs,
350 **kwargs)
Brian Silverman9c614bc2016-02-15 20:20:02 -0500351
Brian Silverman9c614bc2016-02-15 20:20:02 -0500352def py_proto_library(
353 name,
354 srcs=[],
355 deps=[],
356 py_libs=[],
357 py_extra_srcs=[],
Brian Silverman7b8899e2018-06-30 19:19:24 -0700358 py_imports=[],
Brian Silverman9c614bc2016-02-15 20:20:02 -0500359 include=None,
Austin Schuhf9724442018-10-28 20:30:21 -0700360 default_runtime="@com_google_protobuf//:protobuf_python",
361 protoc="@com_google_protobuf//:protoc",
362 use_grpc_plugin=False,
Brian Silverman9c614bc2016-02-15 20:20:02 -0500363 **kargs):
364 """Bazel rule to create a Python protobuf library from proto source files
365
366 NOTE: the rule is only an internal workaround to generate protos. The
367 interface may change and the rule may be removed when bazel has introduced
368 the native rule.
369
370 Args:
371 name: the name of the py_proto_library.
372 srcs: the .proto files of the py_proto_library.
373 deps: a list of dependency labels; must be py_proto_library.
374 py_libs: a list of other py_library targets depended by the generated
375 py_library.
376 py_extra_srcs: extra source files that will be added to the output
377 py_library. This attribute is used for internal bootstrapping.
378 include: a string indicating the include path of the .proto files.
379 default_runtime: the implicitly default runtime which will be depended on by
380 the generated py_library target.
381 protoc: the label of the protocol compiler to generate the sources.
Austin Schuhf9724442018-10-28 20:30:21 -0700382 use_grpc_plugin: a flag to indicate whether to call the Python C++ plugin
383 when processing the proto files.
Brian Silverman9c614bc2016-02-15 20:20:02 -0500384 **kargs: other keyword arguments that are passed to cc_library.
385
386 """
Austin Schuhf9724442018-10-28 20:30:21 -0700387 outs = _PyOuts(srcs, use_grpc_plugin)
Brian Silverman9c614bc2016-02-15 20:20:02 -0500388
389 includes = []
390 if include != None:
391 includes = [include]
392
Austin Schuhf9724442018-10-28 20:30:21 -0700393 grpc_python_plugin = None
394 if use_grpc_plugin:
395 grpc_python_plugin = "//external:grpc_python_plugin"
396 # Note: Generated grpc code depends on Python grpc module. This dependency
397 # is not explicitly listed in py_libs. Instead, host system is assumed to
398 # have grpc installed.
399
400 proto_gen(
Brian Silverman9c614bc2016-02-15 20:20:02 -0500401 name=name + "_genproto",
402 srcs=srcs,
403 deps=[s + "_genproto" for s in deps],
404 includes=includes,
405 protoc=protoc,
406 gen_py=1,
407 outs=outs,
408 visibility=["//visibility:public"],
Austin Schuhf9724442018-10-28 20:30:21 -0700409 plugin=grpc_python_plugin,
410 plugin_language="grpc"
Brian Silverman9c614bc2016-02-15 20:20:02 -0500411 )
412
Brian Silverman9c614bc2016-02-15 20:20:02 -0500413 if default_runtime and not default_runtime in py_libs + deps:
Austin Schuhbe8c9b12017-11-25 15:53:12 -0800414 py_libs = py_libs + [default_runtime]
Brian Silverman9c614bc2016-02-15 20:20:02 -0500415
416 native.py_library(
417 name=name,
418 srcs=outs+py_extra_srcs,
419 deps=py_libs+deps,
Austin Schuhf9724442018-10-28 20:30:21 -0700420 imports=includes,
Brian Silverman9c614bc2016-02-15 20:20:02 -0500421 **kargs)
422
423def internal_protobuf_py_tests(
424 name,
425 modules=[],
426 **kargs):
427 """Bazel rules to create batch tests for protobuf internal.
428
429 Args:
430 name: the name of the rule.
431 modules: a list of modules for tests. The macro will create a py_test for
432 each of the parameter with the source "google/protobuf/%s.py"
433 kargs: extra parameters that will be passed into the py_test.
434
435 """
436 for m in modules:
Austin Schuhf9724442018-10-28 20:30:21 -0700437 s = "python/google/protobuf/internal/%s.py" % m
Brian Silverman9c614bc2016-02-15 20:20:02 -0500438 native.py_test(
439 name="py_%s" % m,
440 srcs=[s],
441 main=s,
442 **kargs)
Austin Schuhf9724442018-10-28 20:30:21 -0700443
444
445def check_protobuf_required_bazel_version():
446 """For WORKSPACE files, to check the installed version of bazel.
447
448 This ensures bazel supports our approach to proto_library() depending on a
449 copied filegroup. (Fixed in bazel 0.5.4)
450 """
451 expected = apple_common.dotted_version("0.5.4")
452 current = apple_common.dotted_version(native.bazel_version)
453 if current.compare_to(expected) < 0:
454 fail("Bazel must be newer than 0.5.4")