aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/github.com/sylvia7788/contextcheck/README.md
diff options
context:
space:
mode:
authorTaras Madan <tarasmadan@google.com>2022-09-05 14:27:54 +0200
committerGitHub <noreply@github.com>2022-09-05 12:27:54 +0000
commitb2f2446b46bf02821d90ebedadae2bf7ae0e880e (patch)
tree923cf42842918d6bebca1d6bbdc08abed54d274d /vendor/github.com/sylvia7788/contextcheck/README.md
parente6654faff4bcca4be92e9a8596fd4b77f747c39e (diff)
go.mod, vendor: update (#3358)
* go.mod, vendor: remove unnecessary dependencies Commands: 1. go mod tidy 2. go mod vendor * go.mod, vendor: update cloud.google.com/go Commands: 1. go get -u cloud.google.com/go 2. go mod tidy 3. go mod vendor * go.mod, vendor: update cloud.google.com/* Commands: 1. go get -u cloud.google.com/storage cloud.google.com/logging 2. go mod tidy 3. go mod vendor * go.mod, .golangci.yml, vendor: update *lint* Commands: 1. go get -u golang.org/x/tools github.com/golangci/golangci-lint@v1.47.0 2. go mod tidy 3. go mod vendor 4. edit .golangci.yml to suppress new errors (resolved in the same PR later) * all: fix lint errors hash.go: copy() recommended by gosimple parse.go: ent is never nil verifier.go: signal.Notify() with unbuffered channel is bad. Have no idea why. * .golangci.yml: adjust godot rules check-all is deprecated, but still work if you're hesitating too - I'll remove this commit
Diffstat (limited to 'vendor/github.com/sylvia7788/contextcheck/README.md')
-rw-r--r--vendor/github.com/sylvia7788/contextcheck/README.md61
1 files changed, 61 insertions, 0 deletions
diff --git a/vendor/github.com/sylvia7788/contextcheck/README.md b/vendor/github.com/sylvia7788/contextcheck/README.md
new file mode 100644
index 000000000..dc951aca4
--- /dev/null
+++ b/vendor/github.com/sylvia7788/contextcheck/README.md
@@ -0,0 +1,61 @@
+[![CircleCI](https://circleci.com/gh/sylvia7788/contextcheck.svg?style=svg)](https://circleci.com/gh/sylvia7788/contextcheck)
+
+
+# contextcheck
+
+`contextcheck` is a static analysis tool, it is used to check the function whether use a non-inherited context, which will result in a broken call link.
+
+For example:
+
+```go
+func call1(ctx context.Context) {
+ ...
+
+ ctx = getNewCtx(ctx)
+ call2(ctx) // OK
+
+ call2(context.Background()) // Non-inherited new context, use function like `context.WithXXX` instead
+
+ call3() // Function `call3` should pass the context parameter
+ ...
+}
+
+func call2(ctx context.Context) {
+ ...
+}
+
+func call3() {
+ ctx := context.TODO()
+ call2(ctx)
+}
+
+func getNewCtx(ctx context.Context) (newCtx context.Context) {
+ ...
+ return
+}
+```
+
+## Installation
+
+You can get `contextcheck` by `go get` command.
+
+```bash
+$ go get -u github.com/sylvia7788/contextcheck
+```
+
+or build yourself.
+
+```bash
+$ make build
+$ make install
+```
+
+## Usage
+
+Invoke `contextcheck` with your package name
+
+```bash
+$ contextcheck ./...
+$ # or
+$ go vet -vettool=`which contextcheck` ./...
+```