go-tools

module
v0.0.0-...-0c6a35b Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 17, 2019 License: BSD-3-Clause

README

Go Tools

This subrepository holds the source for various packages and tools that support the Go programming language.

Some of the tools, godoc and vet for example, are included in binary Go distributions.

Others, including the Go guru and the test coverage tool, can be fetched with go get.

Packages include a type-checker for Go and an implementation of the Static Single Assignment form (SSA) representation for Go programs.

Download/Install

The easiest way to install is to run go get -u golang.org/x/tools/.... You can also manually git clone the repository to $GOPATH/src/golang.org/x/tools.

Report Issues / Send Patches

This repository uses Gerrit for code changes. To learn how to submit changes to this repository, see https://golang.org/doc/contribute.html.

The main issue tracker for the tools repository is located at https://github.com/golang/go/issues. Prefix your issue with "x/tools/(your subdir):" in the subject line, so it is easy to find.

Directories

Path Synopsis
benchmark
parse
Package parse provides support for parsing benchmark results as generated by 'go test -bench'.
 Package parse provides support for parsing benchmark results as generated by 'go test -bench'.
Package blog implements a web server for articles written in present format.
 Package blog implements a web server for articles written in present format.
atom
Package atom defines XML data structures for an Atom feed.
 Package atom defines XML data structures for an Atom feed.
cmd
benchcmp
The benchcmp command displays performance changes between benchmarks.
 The benchcmp command displays performance changes between benchmarks.
bundle
Bundle creates a single-source-file version of a source package suitable for inclusion in a particular target package.
 Bundle creates a single-source-file version of a source package suitable for inclusion in a particular target package.
callgraph
callgraph: a tool for reporting the call graph of a Go program.
 callgraph: a tool for reporting the call graph of a Go program.
compilebench
Compilebench benchmarks the speed of the Go compiler.
 Compilebench benchmarks the speed of the Go compiler.
cover
Cover is a program for analyzing the coverage profiles generated by 'go test -coverprofile=cover.out'.
 Cover is a program for analyzing the coverage profiles generated by 'go test -coverprofile=cover.out'.
digraph
The digraph command performs queries over unlabelled directed graphs represented in text form.
 The digraph command performs queries over unlabelled directed graphs represented in text form.
eg
The eg command performs example-based refactoring.
 The eg command performs example-based refactoring.
fiximports
The fiximports command fixes import declarations to use the canonical import path for packages that have an "import comment" as defined by https://golang.org/s/go14customimport.
 The fiximports command fixes import declarations to use the canonical import path for packages that have an "import comment" as defined by https://golang.org/s/go14customimport.
getgo
The getgo command installs Go to the user's system.
 The getgo command installs Go to the user's system.
getgo/server
Command server serves get.golang.org, redirecting users to the appropriate getgo installer based on the request path.
 Command server serves get.golang.org, redirecting users to the appropriate getgo installer based on the request path.
go-contrib-init
The go-contrib-init command helps new Go contributors get their development environment set up for the Go contribution process.
 The go-contrib-init command helps new Go contributors get their development environment set up for the Go contribution process.
godex
The godex command prints (dumps) exported information of packages or selected package objects.
 The godex command prints (dumps) exported information of packages or selected package objects.
godoc
Godoc extracts and generates documentation for Go programs.
 Godoc extracts and generates documentation for Go programs.
goimports
Command goimports updates your Go import lines, adding missing ones and removing unreferenced ones.
 Command goimports updates your Go import lines, adding missing ones and removing unreferenced ones.
gomvpkg
The gomvpkg command moves go packages, updating import declarations.
 The gomvpkg command moves go packages, updating import declarations.
gopls
The gopls command is an LSP server for Go.
 The gopls command is an LSP server for Go.
gorename
The gorename command performs precise type-safe renaming of identifiers in Go source code.
 The gorename command performs precise type-safe renaming of identifiers in Go source code.
gotype
The gotype command, like the front-end of a Go compiler, parses and type-checks a single Go package.
 The gotype command, like the front-end of a Go compiler, parses and type-checks a single Go package.
goyacc
Goyacc is a version of yacc for Go.
 Goyacc is a version of yacc for Go.
guru
guru: a tool for answering questions about Go source code.
 guru: a tool for answering questions about Go source code.
guru/serial
Package serial defines the guru's schema for -json output.
 Package serial defines the guru's schema for -json output.
html2article
This program takes an HTML file and outputs a corresponding article file in present format.
 This program takes an HTML file and outputs a corresponding article file in present format.
present
Present displays slide presentations and articles.
 Present displays slide presentations and articles.
splitdwarf
Splitdwarf uncompresses and copies the DWARF segment of a Mach-O executable into the "dSYM" file expected by lldb and ports of gdb on OSX.
 Splitdwarf uncompresses and copies the DWARF segment of a Mach-O executable into the "dSYM" file expected by lldb and ports of gdb on OSX.
splitdwarf/internal/macho
Package macho implements access to Mach-O object files.
 Package macho implements access to Mach-O object files.
ssadump
ssadump: a tool for displaying and interpreting the SSA form of Go programs.
 ssadump: a tool for displaying and interpreting the SSA form of Go programs.
stress
The stress utility is intended for catching sporadic failures.
 The stress utility is intended for catching sporadic failures.
stringer
Stringer is a tool to automate the creation of methods that satisfy the fmt.Stringer interface.
 Stringer is a tool to automate the creation of methods that satisfy the fmt.Stringer interface.
toolstash
Toolstash provides a way to save, run, and restore a known good copy of the Go toolchain and to compare the object files generated by two toolchains.
 Toolstash provides a way to save, run, and restore a known good copy of the Go toolchain and to compare the object files generated by two toolchains.
container
intsets
Package intsets provides Sparse, a compact and fast representation for sparse sets of int values.
 Package intsets provides Sparse, a compact and fast representation for sparse sets of int values.
Package cover provides support for parsing coverage profiles generated by "go test -coverprofile=cover.out".
 Package cover provides support for parsing coverage profiles generated by "go test -coverprofile=cover.out".
go
analysis
The analysis package defines the interface between a modular static analysis and an analysis driver program.
 The analysis package defines the interface between a modular static analysis and an analysis driver program.
analysis/analysistest
Package analysistest provides utilities for testing analyzers.
 Package analysistest provides utilities for testing analyzers.
analysis/cmd/vet
The vet command is a static checker for Go programs.
 The vet command is a static checker for Go programs.
analysis/internal/analysisflags
Package analysisflags defines helpers for processing flags of analysis driver tools.
 Package analysisflags defines helpers for processing flags of analysis driver tools.
analysis/internal/checker
Package checker defines the implementation of the checker commands.
 Package checker defines the implementation of the checker commands.
analysis/internal/facts
Package facts defines a serializable set of analysis.Fact.
 Package facts defines a serializable set of analysis.Fact.
analysis/multichecker
Package multichecker defines the main function for an analysis driver with several analyzers.
 Package multichecker defines the main function for an analysis driver with several analyzers.
analysis/passes/asmdecl
Package asmdecl defines an Analyzer that reports mismatches between assembly files and Go declarations.
 Package asmdecl defines an Analyzer that reports mismatches between assembly files and Go declarations.
analysis/passes/assign
Package assign defines an Analyzer that detects useless assignments.
 Package assign defines an Analyzer that detects useless assignments.
analysis/passes/atomic
Package atomic defines an Analyzer that checks for common mistakes using the sync/atomic package.
 Package atomic defines an Analyzer that checks for common mistakes using the sync/atomic package.
analysis/passes/atomicalign
Package atomicalign defines an Analyzer that checks for non-64-bit-aligned arguments to sync/atomic functions.
 Package atomicalign defines an Analyzer that checks for non-64-bit-aligned arguments to sync/atomic functions.
analysis/passes/bools
Package bools defines an Analyzer that detects common mistakes involving boolean operators.
 Package bools defines an Analyzer that detects common mistakes involving boolean operators.
analysis/passes/buildssa
Package buildssa defines an Analyzer that constructs the SSA representation of an error-free package and returns the set of all functions within it.
 Package buildssa defines an Analyzer that constructs the SSA representation of an error-free package and returns the set of all functions within it.
analysis/passes/buildtag
Package buildtag defines an Analyzer that checks build tags.
 Package buildtag defines an Analyzer that checks build tags.
analysis/passes/cgocall
Package cgocall defines an Analyzer that detects some violations of the cgo pointer passing rules.
 Package cgocall defines an Analyzer that detects some violations of the cgo pointer passing rules.
analysis/passes/composite
Package composite defines an Analyzer that checks for unkeyed composite literals.
 Package composite defines an Analyzer that checks for unkeyed composite literals.
analysis/passes/copylock
Package copylock defines an Analyzer that checks for locks erroneously passed by value.
 Package copylock defines an Analyzer that checks for locks erroneously passed by value.
analysis/passes/ctrlflow
Package ctrlflow is an analysis that provides a syntactic control-flow graph (CFG) for the body of a function.
 Package ctrlflow is an analysis that provides a syntactic control-flow graph (CFG) for the body of a function.
analysis/passes/deepequalerrors
Package deepequalerrors defines an Analyzer that checks for the use of reflect.DeepEqual with error values.
 Package deepequalerrors defines an Analyzer that checks for the use of reflect.DeepEqual with error values.
analysis/passes/findcall
The findcall package defines an Analyzer that serves as a trivial example and test of the Analysis API.
 The findcall package defines an Analyzer that serves as a trivial example and test of the Analysis API.
analysis/passes/findcall/cmd/findcall
The findcall command runs the findcall analyzer.
 The findcall command runs the findcall analyzer.
analysis/passes/httpresponse
Package httpresponse defines an Analyzer that checks for mistakes using HTTP responses.
 Package httpresponse defines an Analyzer that checks for mistakes using HTTP responses.
analysis/passes/inspect
Package inspect defines an Analyzer that provides an AST inspector (go.coder.com/go-tools/go/ast/inspect.Inspect) for the syntax trees of a package.
 Package inspect defines an Analyzer that provides an AST inspector (go.coder.com/go-tools/go/ast/inspect.Inspect) for the syntax trees of a package.
analysis/passes/internal/analysisutil
Package analysisutil defines various helper functions used by two or more packages beneath go/analysis.
 Package analysisutil defines various helper functions used by two or more packages beneath go/analysis.
analysis/passes/loopclosure
Package loopclosure defines an Analyzer that checks for references to enclosing loop variables from within nested functions.
 Package loopclosure defines an Analyzer that checks for references to enclosing loop variables from within nested functions.
analysis/passes/lostcancel
Package lostcancel defines an Analyzer that checks for failure to call a context cancelation function.
 Package lostcancel defines an Analyzer that checks for failure to call a context cancelation function.
analysis/passes/lostcancel/cmd/lostcancel
The lostcancel command applies the go.coder.com/go-tools/go/analysis/passes/lostcancel analysis to the specified packages of Go source code.
 The lostcancel command applies the go.coder.com/go-tools/go/analysis/passes/lostcancel analysis to the specified packages of Go source code.
analysis/passes/nilfunc
Package nilfunc defines an Analyzer that checks for useless comparisons against nil.
 Package nilfunc defines an Analyzer that checks for useless comparisons against nil.
analysis/passes/nilness
Package nilness inspects the control-flow graph of an SSA function and reports errors such as nil pointer dereferences and degenerate nil pointer comparisons.
 Package nilness inspects the control-flow graph of an SSA function and reports errors such as nil pointer dereferences and degenerate nil pointer comparisons.
analysis/passes/nilness/cmd/nilness
The nilness command applies the go.coder.com/go-tools/go/analysis/passes/nilness analysis to the specified packages of Go source code.
 The nilness command applies the go.coder.com/go-tools/go/analysis/passes/nilness analysis to the specified packages of Go source code.
analysis/passes/pkgfact
The pkgfact package is a demonstration and test of the package fact mechanism.
 The pkgfact package is a demonstration and test of the package fact mechanism.
analysis/passes/printf
analysis/passes/shadow
analysis/passes/shadow/cmd/shadow
The shadow command runs the shadow analyzer.
 The shadow command runs the shadow analyzer.
analysis/passes/shift
Package shift defines an Analyzer that checks for shifts that exceed the width of an integer.
 Package shift defines an Analyzer that checks for shifts that exceed the width of an integer.
analysis/passes/stdmethods
Package stdmethods defines an Analyzer that checks for misspellings in the signatures of methods similar to well-known interfaces.
 Package stdmethods defines an Analyzer that checks for misspellings in the signatures of methods similar to well-known interfaces.
analysis/passes/structtag
Package structtag defines an Analyzer that checks struct field tags are well formed.
 Package structtag defines an Analyzer that checks struct field tags are well formed.
analysis/passes/tests
Package tests defines an Analyzer that checks for common mistaken usages of tests and examples.
 Package tests defines an Analyzer that checks for common mistaken usages of tests and examples.
analysis/passes/unmarshal
The unmarshal package defines an Analyzer that checks for passing non-pointer or non-interface types to unmarshal and decode functions.
 The unmarshal package defines an Analyzer that checks for passing non-pointer or non-interface types to unmarshal and decode functions.
analysis/passes/unmarshal/cmd/unmarshal
The unmarshal command runs the unmarshal analyzer.
 The unmarshal command runs the unmarshal analyzer.
analysis/passes/unreachable
Package unreachable defines an Analyzer that checks for unreachable code.
 Package unreachable defines an Analyzer that checks for unreachable code.
analysis/passes/unsafeptr
Package unsafeptr defines an Analyzer that checks for invalid conversions of uintptr to unsafe.Pointer.
 Package unsafeptr defines an Analyzer that checks for invalid conversions of uintptr to unsafe.Pointer.
analysis/passes/unusedresult
Package unusedresult defines an analyzer that checks for unused results of calls to certain pure functions.
 Package unusedresult defines an analyzer that checks for unused results of calls to certain pure functions.
analysis/singlechecker
Package singlechecker defines the main function for an analysis driver with only a single analysis.
 Package singlechecker defines the main function for an analysis driver with only a single analysis.
analysis/unitchecker
The unitchecker package defines the main function for an analysis driver that analyzes a single compilation unit during a build.
 The unitchecker package defines the main function for an analysis driver that analyzes a single compilation unit during a build.
ast/astutil
Package astutil contains common utilities for working with the Go AST.
 Package astutil contains common utilities for working with the Go AST.
ast/inspector
Package inspector provides helper functions for traversal over the syntax trees of a package, including node filtering by type, and materialization of the traversal stack.
 Package inspector provides helper functions for traversal over the syntax trees of a package, including node filtering by type, and materialization of the traversal stack.
buildutil
Package buildutil provides utilities related to the go/build package in the standard library.
 Package buildutil provides utilities related to the go/build package in the standard library.
callgraph
Package callgraph defines the call graph and various algorithms and utilities to operate on it.
 Package callgraph defines the call graph and various algorithms and utilities to operate on it.
callgraph/cha
Package cha computes the call graph of a Go program using the Class Hierarchy Analysis (CHA) algorithm.
 Package cha computes the call graph of a Go program using the Class Hierarchy Analysis (CHA) algorithm.
callgraph/rta
This package provides Rapid Type Analysis (RTA) for Go, a fast algorithm for call graph construction and discovery of reachable code (and hence dead code) and runtime types.
 This package provides Rapid Type Analysis (RTA) for Go, a fast algorithm for call graph construction and discovery of reachable code (and hence dead code) and runtime types.
callgraph/static
Package static computes the call graph of a Go program containing only static call edges.
 Package static computes the call graph of a Go program containing only static call edges.
cfg
This package constructs a simple control-flow graph (CFG) of the statements and expressions within a single function.
 This package constructs a simple control-flow graph (CFG) of the statements and expressions within a single function.
expect
Package expect provides support for interpreting structured comments in Go source code as test expectations.
 Package expect provides support for interpreting structured comments in Go source code as test expectations.
gccgoexportdata
Package gccgoexportdata provides functions for reading export data files containing type information produced by the gccgo compiler.
 Package gccgoexportdata provides functions for reading export data files containing type information produced by the gccgo compiler.
gcexportdata
Package gcexportdata provides functions for locating, reading, and writing export data files containing type information produced by the gc compiler.
 Package gcexportdata provides functions for locating, reading, and writing export data files containing type information produced by the gc compiler.
internal/cgo
internal/gccgoimporter
Package gccgoimporter implements Import for gccgo-generated object files.
 Package gccgoimporter implements Import for gccgo-generated object files.
internal/gcimporter
Package gcimporter provides various functions for reading gc-generated object files that can be used to implement the Importer interface defined by the Go 1.5 standard library package.
 Package gcimporter provides various functions for reading gc-generated object files that can be used to implement the Importer interface defined by the Go 1.5 standard library package.
internal/packagesdriver
Package packagesdriver fetches type sizes for go/packages and go/analysis.
 Package packagesdriver fetches type sizes for go/packages and go/analysis.
loader
Package loader loads a complete Go program from source code, parsing and type-checking the initial packages plus their transitive closure of dependencies.
 Package loader loads a complete Go program from source code, parsing and type-checking the initial packages plus their transitive closure of dependencies.
packages
Package packages loads Go packages for inspection and analysis.
 Package packages loads Go packages for inspection and analysis.
packages/gopackages
The gopackages command is a diagnostic tool that demonstrates how to use go.coder.com/go-tools/go/packages to load, parse, type-check, and print one or more Go packages.
 The gopackages command is a diagnostic tool that demonstrates how to use go.coder.com/go-tools/go/packages to load, parse, type-check, and print one or more Go packages.
packages/packagestest
Package packagestest creates temporary projects on disk for testing go tools on.
 Package packagestest creates temporary projects on disk for testing go tools on.
pointer
Package pointer implements Andersen's analysis, an inclusion-based pointer analysis algorithm first described in (Andersen, 1994).
 Package pointer implements Andersen's analysis, an inclusion-based pointer analysis algorithm first described in (Andersen, 1994).
ssa
Package ssa defines a representation of the elements of Go programs (packages, types, functions, variables and constants) using a static single-assignment (SSA) form intermediate representation (IR) for the bodies of functions.
 Package ssa defines a representation of the elements of Go programs (packages, types, functions, variables and constants) using a static single-assignment (SSA) form intermediate representation (IR) for the bodies of functions.
ssa/interp
Package ssa/interp defines an interpreter for the SSA representation of Go programs.
 Package ssa/interp defines an interpreter for the SSA representation of Go programs.
ssa/ssautil
types/objectpath
Package objectpath defines a naming scheme for types.Objects (that is, named entities in Go programs) relative to their enclosing package.
 Package objectpath defines a naming scheme for types.Objects (that is, named entities in Go programs) relative to their enclosing package.
types/typeutil
Package typeutil defines various utilities for types, such as Map, a mapping from types.Type to interface{} values.
 Package typeutil defines various utilities for types, such as Map, a mapping from types.Type to interface{} values.
vcs
Package vcs exposes functions for resolving import paths and using version control systems, which can be used to implement behavior similar to the standard "go get" command.
 Package vcs exposes functions for resolving import paths and using version control systems, which can be used to implement behavior similar to the standard "go get" command.
Package godoc is a work-in-progress (2013-07-17) package to begin splitting up the godoc binary into multiple pieces.
 Package godoc is a work-in-progress (2013-07-17) package to begin splitting up the godoc binary into multiple pieces.
analysis
Package analysis performs type and pointer analysis and generates mark-up for the Go source view.
 Package analysis performs type and pointer analysis and generates mark-up for the Go source view.
golangorgenv
Package golangorgenv provides environment information for programs running at golang.org and its subdomains.
 Package golangorgenv provides environment information for programs running at golang.org and its subdomains.
redirect
Package redirect provides hooks to register HTTP handlers that redirect old godoc paths to their new equivalents and assist in accessing the issue tracker, wiki, code review system, etc.
 Package redirect provides hooks to register HTTP handlers that redirect old godoc paths to their new equivalents and assist in accessing the issue tracker, wiki, code review system, etc.
static
Package static exports a map of static file content that supports the godoc user interface.
 Package static exports a map of static file content that supports the godoc user interface.
util
Package util contains utility types and functions for godoc.
 Package util contains utility types and functions for godoc.
vfs
Package vfs defines types for abstract file system access and provides an implementation accessing the file system of the underlying OS.
 Package vfs defines types for abstract file system access and provides an implementation accessing the file system of the underlying OS.
vfs/gatefs
Package gatefs provides an implementation of the FileSystem interface that wraps another FileSystem and limits its concurrency.
 Package gatefs provides an implementation of the FileSystem interface that wraps another FileSystem and limits its concurrency.
vfs/httpfs
Package httpfs implements http.FileSystem using a godoc vfs.FileSystem.
 Package httpfs implements http.FileSystem using a godoc vfs.FileSystem.
vfs/mapfs
Package mapfs file provides an implementation of the FileSystem interface based on the contents of a map[string]string.
 Package mapfs file provides an implementation of the FileSystem interface based on the contents of a map[string]string.
vfs/zipfs
Package zipfs file provides an implementation of the FileSystem interface based on the contents of a .zip file.
 Package zipfs file provides an implementation of the FileSystem interface based on the contents of a .zip file.
Package imports implements a Go pretty-printer (like package "go/format") that also adds or removes import statements as necessary.
 Package imports implements a Go pretty-printer (like package "go/format") that also adds or removes import statements as necessary.
internal
fastwalk
Package fastwalk provides a faster version of filepath.Walk for file system scanning tools.
 Package fastwalk provides a faster version of filepath.Walk for file system scanning tools.
gopathwalk
Package gopathwalk is like filepath.Walk but specialized for finding Go packages, particularly in $GOPATH and $GOROOT.
 Package gopathwalk is like filepath.Walk but specialized for finding Go packages, particularly in $GOPATH and $GOROOT.
jsonrpc2
Package jsonrpc2 is a minimal implementation of the JSON RPC 2 spec.
 Package jsonrpc2 is a minimal implementation of the JSON RPC 2 spec.
lsp
lsp/cache
lsp/cmd
Package cmd handles the gopls command line.
 Package cmd handles the gopls command line.
lsp/diff
Package diff implements the Myers diff algorithm.
 Package diff implements the Myers diff algorithm.
lsp/protocol
Package protocol contains the structs that map directly to the wire format of the "Language Server Protocol".
 Package protocol contains the structs that map directly to the wire format of the "Language Server Protocol".
lsp/protocol/preserve
lsp/source
Package source provides core features for use by Go editors and tools.
 Package source provides core features for use by Go editors and tools.
module
Package module defines the module.Version type along with support code.
 Package module defines the module.Version type along with support code.
semver
Package semver implements comparison of semantic version strings.
 Package semver implements comparison of semantic version strings.
span
tool
Package tool is an opinionated harness for writing Go tools.
 Package tool is an opinionated harness for writing Go tools.
txtar
Package txtar implements a trivial text-based file archive format.
 Package txtar implements a trivial text-based file archive format.
Package playground registers HTTP handlers at "/compile" and "/share" that proxy requests to the golang.org playground service.
 Package playground registers HTTP handlers at "/compile" and "/share" that proxy requests to the golang.org playground service.
socket
Package socket implements an WebSocket-based playground backend.
 Package socket implements an WebSocket-based playground backend.
The present file format Present files have the following format.
 The present file format Present files have the following format.
refactor
eg
Package eg implements the example-based refactoring tool whose command-line is defined in go.coder.com/go-tools/cmd/eg.
 Package eg implements the example-based refactoring tool whose command-line is defined in go.coder.com/go-tools/cmd/eg.
importgraph
Package importgraph computes the forward and reverse import dependency graphs for all packages in a Go workspace.
 Package importgraph computes the forward and reverse import dependency graphs for all packages in a Go workspace.
rename
Package rename contains the implementation of the 'gorename' command whose main function is in go.coder.com/go-tools/cmd/gorename.
 Package rename contains the implementation of the 'gorename' command whose main function is in go.coder.com/go-tools/cmd/gorename.
satisfy
Package satisfy inspects the type-checked ASTs of Go packages and reports the set of discovered type constraints of the form (lhs, rhs Type) where lhs is a non-trivial interface, rhs satisfies this interface, and this fact is necessary for the package to be well-typed.
 Package satisfy inspects the type-checked ASTs of Go packages and reports the set of discovered type constraints of the form (lhs, rhs Type) where lhs is a non-trivial interface, rhs satisfies this interface, and this fact is necessary for the package to be well-typed.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.