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 |
||||
# 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. |
||||
protoc -I ../../protos --python_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_python_plugin` ../../protos/helloworld.proto |
||||
|
@ -1,4 +1,32 @@ |
||||
#!/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. |
||||
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