mirror of
https://github.com/etcd-io/etcd.git
synced 2024-09-27 06:25:44 +00:00
*: add swagger and grpc-gateway assets for v3lock and v3election
This commit is contained in:
@@ -68,20 +68,19 @@ for dir in ${DIRS}; do
|
||||
popd
|
||||
done
|
||||
|
||||
protoc -I. \
|
||||
-I${GRPC_GATEWAY_ROOT}/third_party/googleapis \
|
||||
-I${GOGOPROTO_PATH} \
|
||||
-I${COREOS_ROOT} \
|
||||
--grpc-gateway_out=logtostderr=true:. \
|
||||
--swagger_out=logtostderr=true:./Documentation/dev-guide/apispec/swagger/. \
|
||||
./etcdserver/etcdserverpb/rpc.proto
|
||||
|
||||
# TODO: change this whenever we add more swagger API
|
||||
mv \
|
||||
Documentation/dev-guide/apispec/swagger/etcdserver/etcdserverpb/rpc.swagger.json \
|
||||
Documentation/dev-guide/apispec/swagger/rpc.swagger.json
|
||||
rm -rf Documentation/dev-guide/apispec/swagger/etcdserver/etcdserverpb
|
||||
|
||||
for pb in etcdserverpb/rpc api/v3lock/v3lockpb/v3lock api/v3election/v3electionpb/v3election; do
|
||||
protoc -I. \
|
||||
-I${GRPC_GATEWAY_ROOT}/third_party/googleapis \
|
||||
-I${GOGOPROTO_PATH} \
|
||||
-I${COREOS_ROOT} \
|
||||
--grpc-gateway_out=logtostderr=true:. \
|
||||
--swagger_out=logtostderr=true:./Documentation/dev-guide/apispec/swagger/. \
|
||||
./etcdserver/${pb}.proto
|
||||
name=`basename ${pb}`
|
||||
mv Documentation/dev-guide/apispec/swagger/etcdserver/${pb}.swagger.json \
|
||||
Documentation/dev-guide/apispec/swagger/${name}.swagger.json
|
||||
done
|
||||
rm -rf Documentation/dev-guide/apispec/swagger/etcdserver/
|
||||
|
||||
# install protodoc
|
||||
# go get -v -u github.com/coreos/protodoc
|
||||
@@ -106,6 +105,11 @@ if [ "$1" = "-g" ]; then
|
||||
--message-only-from-this-file="etcdserver/etcdserverpb/rpc.proto" \
|
||||
--disclaimer="This is a generated documentation. Please read the proto files for more."
|
||||
|
||||
protodoc --directories="etcdserver/api/v3lock/v3lockpb=service_message,etcdserver/api/v3election/v3electionpb=service_message,mvcc/mvccpb=service_message" \
|
||||
--title="etcd concurrency API Reference" \
|
||||
--output="Documentation/dev-guide/api_concurrency_reference_v3.md" \
|
||||
--disclaimer="This is a generated documentation. Please read the proto files for more."
|
||||
|
||||
echo "protodoc is finished..."
|
||||
else
|
||||
echo "skipping grpc API reference document auto-generation..."
|
||||
|
||||
Reference in New Issue
Block a user