https://github.com/rogpeppe/showdeps

show Go package dependencies
https://github.com/rogpeppe/showdeps

Last synced: about 2 months ago
JSON representation

show Go package dependencies

• Host: GitHub
• URL: https://github.com/rogpeppe/showdeps
• Owner: rogpeppe
• License: gpl-2.0
• Created: 2014-09-15T13:47:56.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2018-07-19T11:05:54.000Z (almost 7 years ago)
• Last Synced: 2025-03-18T06:51:25.568Z (2 months ago)
• Language: Go
• Size: 21.5 KB
• Stars: 52
• Watchers: 5
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Showdeps - an opinionated tool for inspecting Go package dependencies

----------------

Showdeps starts where `go list -f` leaves off. It's useful for exploring

dependency graphs of Go programs.

By default, showdeps just shows the packages imported by the packages

named on the command line. It doesn't show those packages themselves,

it doesn't recursively visit all dependencies, and it doesn't show

dependencies in the standard library.

You can specify additional flags to show all of those things:

The `-a` flag will show all dependencies recursively.  By default

this will include testing dependencies but only those of the packages

specifically mentioned.  This keeps the dependency graph from becoming

too unwieldy due the testing dependencies in external repositories that

you really don't care about.

The `-stdlib` flag will include dependencies from the standard

library. These are excluded by default because dependencies on the

standard library are rarely a problem.

The `-T` flag causes test dependencies to be omitted.  With `-T`

specified, you'll see the exact dependencies of the package without

pollution from test-related code.

There are other flags that provide more insight into the details of

the dependencies.

The `-from` flag shows *why* each dependency is included by printing,

along with each package, the list of packages that depend on it.

The `-why` flag can be used to explore just why a particular package has

been included in the result. By default, it shows a single dependency chain

(a sequence of package names that import each other) from

the listed packages to any package matched by the `=why` argument.

If the -a flag is provided, it instead prints all packages

that are part of any of those chains in `-from` style.

Finally, the `-f` flag causes all the Go source file names to be printed.

Since this is usually for whole-program greps or analysis, this also

includes the source files in the packages specified on the command line.

Examples:

--------

Print the immediate dependencies of the package

in the current directory:

	$ showdeps

Print the import pages of all the packages used directly and indirectly by net/http.

	$ showdeps -a -stdlib -T net/http

Show a line count of all the packages underneath

the current directory and their dependencies.

	$ showdeps -a -f ./... | xargs cat | wc -l

Find out one reason why net/http indirectly imports crypto/x509/pkix:

	$ showdeps -T  -why crypto/x509/pkix net/http

	net/http crypto/tls crypto/x509 crypto/x509/pkix