mirror of https://github.com/grpc/grpc.git
commit
4dfe317e5d
381 changed files with 3770 additions and 7917 deletions
@ -0,0 +1,65 @@ |
|||||||
|
GRPC C STYLE GUIDE |
||||||
|
===================== |
||||||
|
|
||||||
|
Background |
||||||
|
---------- |
||||||
|
|
||||||
|
Here we document style rules for C usage in the gRPC Core library. |
||||||
|
|
||||||
|
General |
||||||
|
------- |
||||||
|
|
||||||
|
- Layout rules are defined by clang-format, and all code should be passed through |
||||||
|
clang-format. A (docker-based) script to do so is included in |
||||||
|
tools/distrib/clang_format_code.sh. |
||||||
|
|
||||||
|
Header Files |
||||||
|
------------ |
||||||
|
|
||||||
|
- Public header files (those in the include/grpc tree) should compile as pedantic C89 |
||||||
|
- Public header files should be includable from C++ programs. That is, they should |
||||||
|
include the following: |
||||||
|
```c |
||||||
|
#ifdef __cplusplus |
||||||
|
extern "C" { |
||||||
|
# endif |
||||||
|
|
||||||
|
/* ... body of file ... */ |
||||||
|
|
||||||
|
#ifdef __cplusplus |
||||||
|
} |
||||||
|
# endif |
||||||
|
``` |
||||||
|
- Header files should be self-contained and end in .h. |
||||||
|
- All header files should have a #define guard to prevent multiple inclusion. |
||||||
|
To guarantee uniqueness they should be based on the file's path. |
||||||
|
|
||||||
|
For public headers: include/grpc/grpc.h --> GRPC_GRPC_H |
||||||
|
|
||||||
|
For private headers: |
||||||
|
src/core/channel/channel_stack.h --> GRPC_INTERNAL_CORE_CHANNEL_CHANNEL_STACK_H |
||||||
|
|
||||||
|
C99 Features |
||||||
|
------------ |
||||||
|
|
||||||
|
- Variable sized arrays are not allowed |
||||||
|
- Do not use the 'inline' keyword |
||||||
|
- Flexible array members are allowed (https://en.wikipedia.org/wiki/Flexible_array_member) |
||||||
|
|
||||||
|
Comments |
||||||
|
-------- |
||||||
|
|
||||||
|
Within public header files, only `/* */` comments are allowed. |
||||||
|
|
||||||
|
Within implementation files and private headers, either single line `//` |
||||||
|
or multi line `/* */` comments are allowed. Only one comment style per file is |
||||||
|
allowed however (i.e. if single line comments are used anywhere within a file, |
||||||
|
ALL comments within that file must be single line comments). |
||||||
|
|
||||||
|
Symbol Names |
||||||
|
------------ |
||||||
|
|
||||||
|
- Non-static functions must be prefixed by grpc_ |
||||||
|
- static functions must not be prefixed by grpc_ |
||||||
|
- enumeration values and #define names are uppercased, all others are lowercased |
||||||
|
- Multiple word identifiers use underscore as a delimiter (NEVER camel casing) |
@ -1,4 +1,32 @@ |
|||||||
#!/bin/bash |
#!/bin/bash |
||||||
|
# Copyright 2015, Google Inc. |
||||||
|
# All rights reserved. |
||||||
|
# |
||||||
|
# Redistribution and use in source and binary forms, with or without |
||||||
|
# modification, are permitted provided that the following conditions are |
||||||
|
# met: |
||||||
|
# |
||||||
|
# * Redistributions of source code must retain the above copyright |
||||||
|
# notice, this list of conditions and the following disclaimer. |
||||||
|
# * Redistributions in binary form must reproduce the above |
||||||
|
# copyright notice, this list of conditions and the following disclaimer |
||||||
|
# in the documentation and/or other materials provided with the |
||||||
|
# distribution. |
||||||
|
# * Neither the name of Google Inc. nor the names of its |
||||||
|
# contributors may be used to endorse or promote products derived from |
||||||
|
# this software without specific prior written permission. |
||||||
|
# |
||||||
|
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||||
|
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||||
|
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||||
|
# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||||
|
# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||||
|
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||||
|
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||||
|
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||||
|
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||||
|
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||||
|
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
||||||
|
|
||||||
# Runs the protoc with gRPC plugin to generate protocol messages and gRPC stubs. |
# Runs the protoc with gRPC plugin to generate protocol messages and gRPC stubs. |
||||||
protoc -I ../../protos --python_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_python_plugin` ../../protos/helloworld.proto |
protoc -I ../../protos --python_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_python_plugin` ../../protos/helloworld.proto |
||||||
|
@ -1,4 +1,32 @@ |
|||||||
#!/bin/bash |
#!/bin/bash |
||||||
|
# Copyright 2015, Google Inc. |
||||||
|
# All rights reserved. |
||||||
|
# |
||||||
|
# Redistribution and use in source and binary forms, with or without |
||||||
|
# modification, are permitted provided that the following conditions are |
||||||
|
# met: |
||||||
|
# |
||||||
|
# * Redistributions of source code must retain the above copyright |
||||||
|
# notice, this list of conditions and the following disclaimer. |
||||||
|
# * Redistributions in binary form must reproduce the above |
||||||
|
# copyright notice, this list of conditions and the following disclaimer |
||||||
|
# in the documentation and/or other materials provided with the |
||||||
|
# distribution. |
||||||
|
# * Neither the name of Google Inc. nor the names of its |
||||||
|
# contributors may be used to endorse or promote products derived from |
||||||
|
# this software without specific prior written permission. |
||||||
|
# |
||||||
|
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||||
|
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||||
|
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||||
|
# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||||
|
# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||||
|
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||||
|
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||||
|
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||||
|
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||||
|
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||||
|
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
||||||
|
|
||||||
# Runs the protoc with gRPC plugin to generate protocol messages and gRPC stubs. |
# Runs the protoc with gRPC plugin to generate protocol messages and gRPC stubs. |
||||||
protoc -I ../../protos --python_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_python_plugin` ../../protos/route_guide.proto |
protoc -I ../../protos --python_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_python_plugin` ../../protos/route_guide.proto |
||||||
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue