grpc
/
grpc-java
mirror of https://github.com/grpc/grpc-java.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

java_grpc_library.bzl: Fix docstring to match Bazel style 

https://github.com/bazelbuild/buildtools/blob/master/WARNINGS.md#function-docstring-header

Made some additional changes to make the doc more clear.
This commit is contained in:
Eric Anderson 2019-04-23 12:07:29 -07:00
parent 04e07034f3
commit 1214781995
1 changed files with 10 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
java_grpc_library.bzl
View File

@ -166,24 +166,21 @@ def java_grpc_library(
deps, deps,
flavor = None, flavor = None,
**kwargs): **kwargs):
"""Generates and compiles gRPC Java sources for services defined in a proto """Generates gRPC Java code for services in a `proto_library`.
file. This rule is compatible with proto_library with java_api_version,
java_proto_library, and java_lite_proto_library.
Do note that this rule only scans through the proto file for RPC services. It This rule only generates code for services; it does not generate code for
does not generate Java classes for proto messages. You will need a separate messages. You will need a separate java_proto_library or
proto_library with java_api_version, java_proto_library, or
java_lite_proto_library rule. java_lite_proto_library rule.
Args: Args:
name: (str) A unique name for this rule. Required. name: A unique name for this rule.
srcs: (list) a single proto_library target that contains the schema of the srcs: (List of `labels`) a single proto_library target that contains the
service. Required. schema of the service.
deps: (list) a single java_proto_library target for the proto_library in deps: (List of `labels`) a single java_proto_library or
srcs. Required. java_lite_proto_library target for the proto_library in srcs.
flavor: (str) "normal" (default) for normal proto runtime. "lite" flavor: (str) "normal" (default) for normal proto runtime. "lite"
for the lite runtime. for the lite runtime.
**kwargs: Passed through to generated targets **kwargs: Other common attributes
""" """
if len(deps) > 1: if len(deps) > 1: