213 lines
6.6 KiB
Bash
213 lines
6.6 KiB
Bash
#!/bin/bash
|
|
|
|
set -ex # Exit on error; debugging enabled.
|
|
set -o pipefail # Fail a pipe if any sub-command fails.
|
|
|
|
# not makes sure the command passed to it does not exit with a return code of 0.
|
|
not() {
|
|
# This is required instead of the earlier (! $COMMAND) because subshells and
|
|
# pipefail don't work the same on Darwin as in Linux.
|
|
! "$@"
|
|
}
|
|
|
|
die() {
|
|
echo "$@" >&2
|
|
exit 1
|
|
}
|
|
|
|
fail_on_output() {
|
|
tee /dev/stderr | not read
|
|
}
|
|
|
|
# Check to make sure it's safe to modify the user's git repo.
|
|
git status --porcelain | fail_on_output
|
|
|
|
# Undo any edits made by this script.
|
|
cleanup() {
|
|
git reset --hard HEAD
|
|
}
|
|
trap cleanup EXIT
|
|
|
|
PATH="${HOME}/go/bin:${GOROOT}/bin:${PATH}"
|
|
go version
|
|
|
|
if [[ "$1" = "-install" ]]; then
|
|
# Install the pinned versions as defined in module tools.
|
|
pushd ./test/tools
|
|
go install \
|
|
golang.org/x/lint/golint \
|
|
golang.org/x/tools/cmd/goimports \
|
|
honnef.co/go/tools/cmd/staticcheck \
|
|
github.com/client9/misspell/cmd/misspell
|
|
popd
|
|
if [[ -z "${VET_SKIP_PROTO}" ]]; then
|
|
if [[ "${GITHUB_ACTIONS}" = "true" ]]; then
|
|
PROTOBUF_VERSION=22.0 # a.k.a v4.22.0 in pb.go files.
|
|
PROTOC_FILENAME=protoc-${PROTOBUF_VERSION}-linux-x86_64.zip
|
|
pushd /home/runner/go
|
|
wget https://github.com/google/protobuf/releases/download/v${PROTOBUF_VERSION}/${PROTOC_FILENAME}
|
|
unzip ${PROTOC_FILENAME}
|
|
bin/protoc --version
|
|
popd
|
|
elif not which protoc > /dev/null; then
|
|
die "Please install protoc into your path"
|
|
fi
|
|
fi
|
|
exit 0
|
|
elif [[ "$#" -ne 0 ]]; then
|
|
die "Unknown argument(s): $*"
|
|
fi
|
|
|
|
# - Check that generated proto files are up to date.
|
|
if [[ -z "${VET_SKIP_PROTO}" ]]; then
|
|
make proto && git status --porcelain 2>&1 | fail_on_output || \
|
|
(git status; git --no-pager diff; exit 1)
|
|
fi
|
|
|
|
if [[ -n "${VET_ONLY_PROTO}" ]]; then
|
|
exit 0
|
|
fi
|
|
|
|
# - Ensure all source files contain a copyright message.
|
|
# (Done in two parts because Darwin "git grep" has broken support for compound
|
|
# exclusion matches.)
|
|
(grep -L "DO NOT EDIT" $(git grep -L "\(Copyright [0-9]\{4,\} gRPC authors\)" -- '*.go') || true) | fail_on_output
|
|
|
|
# - Make sure all tests in grpc and grpc/test use leakcheck via Teardown.
|
|
not grep 'func Test[^(]' *_test.go
|
|
not grep 'func Test[^(]' test/*.go
|
|
|
|
# - Do not import x/net/context.
|
|
not git grep -l 'x/net/context' -- "*.go"
|
|
|
|
# - Do not import math/rand for real library code. Use internal/grpcrand for
|
|
# thread safety.
|
|
git grep -l '"math/rand"' -- "*.go" 2>&1 | not grep -v '^examples\|^stress\|grpcrand\|^benchmark\|wrr_test'
|
|
|
|
# - Do not use "interface{}"; use "any" instead.
|
|
git grep -l 'interface{}' -- "*.go" 2>&1 | not grep -v '\.pb\.go\|protoc-gen-go-grpc'
|
|
|
|
# - Do not call grpclog directly. Use grpclog.Component instead.
|
|
git grep -l -e 'grpclog.I' --or -e 'grpclog.W' --or -e 'grpclog.E' --or -e 'grpclog.F' --or -e 'grpclog.V' -- "*.go" | not grep -v '^grpclog/component.go\|^internal/grpctest/tlogger_test.go'
|
|
|
|
# - Ensure all ptypes proto packages are renamed when importing.
|
|
not git grep "\(import \|^\s*\)\"github.com/golang/protobuf/ptypes/" -- "*.go"
|
|
|
|
# - Ensure all usages of grpc_testing package are renamed when importing.
|
|
not git grep "\(import \|^\s*\)\"google.golang.org/grpc/interop/grpc_testing" -- "*.go"
|
|
|
|
# - Ensure all xds proto imports are renamed to *pb or *grpc.
|
|
git grep '"github.com/envoyproxy/go-control-plane/envoy' -- '*.go' ':(exclude)*.pb.go' | not grep -v 'pb "\|grpc "'
|
|
|
|
misspell -error .
|
|
|
|
# - gofmt, goimports, golint (with exceptions for generated code), go vet,
|
|
# go mod tidy.
|
|
# Perform these checks on each module inside gRPC.
|
|
for MOD_FILE in $(find . -name 'go.mod'); do
|
|
MOD_DIR=$(dirname ${MOD_FILE})
|
|
pushd ${MOD_DIR}
|
|
go vet -all ./... | fail_on_output
|
|
gofmt -s -d -l . 2>&1 | fail_on_output
|
|
goimports -l . 2>&1 | not grep -vE "\.pb\.go"
|
|
golint ./... 2>&1 | not grep -vE "/grpc_testing_not_regenerate/.*\.pb\.go:"
|
|
|
|
go mod tidy -compat=1.19
|
|
git status --porcelain 2>&1 | fail_on_output || \
|
|
(git status; git --no-pager diff; exit 1)
|
|
popd
|
|
done
|
|
|
|
# - Collection of static analysis checks
|
|
#
|
|
# TODO(dfawley): don't use deprecated functions in examples or first-party
|
|
# plugins.
|
|
# TODO(dfawley): enable ST1019 (duplicate imports) but allow for protobufs.
|
|
SC_OUT="$(mktemp)"
|
|
staticcheck -go 1.19 -checks 'inherit,-ST1015,-ST1019,-SA1019' ./... > "${SC_OUT}" || true
|
|
# Error if anything other than deprecation warnings are printed.
|
|
not grep -v "is deprecated:.*SA1019" "${SC_OUT}"
|
|
# Only ignore the following deprecated types/fields/functions.
|
|
not grep -Fv '.CredsBundle
|
|
.HeaderMap
|
|
.Metadata is deprecated: use Attributes
|
|
.NewAddress
|
|
.NewServiceConfig
|
|
.Type is deprecated: use Attributes
|
|
BuildVersion is deprecated
|
|
balancer.ErrTransientFailure
|
|
balancer.Picker
|
|
extDesc.Filename is deprecated
|
|
github.com/golang/protobuf/jsonpb is deprecated
|
|
grpc.CallCustomCodec
|
|
grpc.Code
|
|
grpc.Compressor
|
|
grpc.CustomCodec
|
|
grpc.Decompressor
|
|
grpc.MaxMsgSize
|
|
grpc.MethodConfig
|
|
grpc.NewGZIPCompressor
|
|
grpc.NewGZIPDecompressor
|
|
grpc.RPCCompressor
|
|
grpc.RPCDecompressor
|
|
grpc.ServiceConfig
|
|
grpc.WithCompressor
|
|
grpc.WithDecompressor
|
|
grpc.WithDialer
|
|
grpc.WithMaxMsgSize
|
|
grpc.WithServiceConfig
|
|
grpc.WithTimeout
|
|
http.CloseNotifier
|
|
info.SecurityVersion
|
|
proto is deprecated
|
|
proto.InternalMessageInfo is deprecated
|
|
proto.EnumName is deprecated
|
|
proto.ErrInternalBadWireType is deprecated
|
|
proto.FileDescriptor is deprecated
|
|
proto.Marshaler is deprecated
|
|
proto.MessageType is deprecated
|
|
proto.RegisterEnum is deprecated
|
|
proto.RegisterFile is deprecated
|
|
proto.RegisterType is deprecated
|
|
proto.RegisterExtension is deprecated
|
|
proto.RegisteredExtension is deprecated
|
|
proto.RegisteredExtensions is deprecated
|
|
proto.RegisterMapType is deprecated
|
|
proto.Unmarshaler is deprecated
|
|
Target is deprecated: Use the Target field in the BuildOptions instead.
|
|
xxx_messageInfo_
|
|
' "${SC_OUT}"
|
|
|
|
# - special golint on package comments.
|
|
lint_package_comment_per_package() {
|
|
# Number of files in this go package.
|
|
fileCount=$(go list -f '{{len .GoFiles}}' $1)
|
|
if [ ${fileCount} -eq 0 ]; then
|
|
return 0
|
|
fi
|
|
# Number of package errors generated by golint.
|
|
lintPackageCommentErrorsCount=$(golint --min_confidence 0 $1 | grep -c "should have a package comment")
|
|
# golint complains about every file that's missing the package comment. If the
|
|
# number of files for this package is greater than the number of errors, there's
|
|
# at least one file with package comment, good. Otherwise, fail.
|
|
if [ ${fileCount} -le ${lintPackageCommentErrorsCount} ]; then
|
|
echo "Package $1 (with ${fileCount} files) is missing package comment"
|
|
return 1
|
|
fi
|
|
}
|
|
lint_package_comment() {
|
|
set +ex
|
|
|
|
count=0
|
|
for i in $(go list ./...); do
|
|
lint_package_comment_per_package "$i"
|
|
((count += $?))
|
|
done
|
|
|
|
set -ex
|
|
return $count
|
|
}
|
|
lint_package_comment
|
|
|
|
echo SUCCESS
|