an [abandoned] attempt to slice out the docker/docker/pkg package
Find a file
Dan Walsh 7b9f693120 --help option and help command should print to stdout not stderr
--help and help are successful commands so output should not go to error.

QE teams have requested this change, also users doing docker help | less
or docker run --help | less would expect this to work.

Usage statement should only be printed when the user asks for it.
Errors should print error message and then suggest the docker COMMAND --help
command to see usage information.

The current behaviour causes the user to have to search for the error message
and sometimes scrolls right off the screen.  For example a error on a
"docker run" command is very difficult to diagnose.

Finally erros should always exit with a non 0 exit code, if the user
makes a CLI error.

Docker-DCO-1.1-Signed-off-by: Dan Walsh <dwalsh@redhat.com> (github: rhatdan)
2014-08-21 15:35:20 -04:00
broadcastwriter Extract log utils into pkg/log 2014-08-13 15:18:15 -07:00
graphdb sqlite-3.6.20-1 unique constraint message 2014-06-19 15:24:22 -04:00
httputils Extract log utils into pkg/log 2014-08-13 15:18:15 -07:00
iptables use stderr to debug iptables 2014-05-30 19:39:42 +00:00
jsonlog utils.Debugf -> log.Printf, move jsonlog to own package. 2014-08-06 16:39:01 -07:00
listenbuffer adding configuration for timeout and disable it by default 2014-03-17 15:12:02 -07:00
log move utils.Fataler to pkg/log.Fataler 2014-08-13 15:32:41 -07:00
mflag --help option and help command should print to stdout not stderr 2014-08-21 15:35:20 -04:00
mount Only import "testing" from *_test.go 2014-08-07 14:25:21 -07:00
namesgenerator Removed :neckbeard: RMS test case 2014-07-16 23:22:21 +01:00
networkfs Relax dns search to accept empty domain 2014-07-04 09:33:53 +01:00
parsers Replace "amd64" build tags with "cgo" as appropriate, and remove where unnecessary 2014-08-06 17:20:21 -06:00
proxy Fix deadlock on failed dial in UDP userland proxy 2014-08-13 17:18:37 +04:00
signal Exit after receiving SIGTERM 2014-08-13 12:18:23 -07:00
symlink add integration test for --workdir=/ 2014-06-25 11:02:59 -04:00
sysinfo update MAINTAINERS files 2014-06-16 22:20:07 +00:00
system Purge the bits of pkg/system that moved to libcontainer/system 2014-08-02 01:35:04 -06:00
systemd Add systemd.SdBooted() 2014-03-27 22:44:31 +01:00
tailfile Implement tail for docker logs 2014-07-01 23:44:12 +04:00
tarsum pkg/tarsum: avoid buf2 allocation in Read 2014-08-17 14:45:11 +03:00
term update go import path and libcontainer 2014-07-24 22:19:50 +00:00
testutils Graphtest is ok to compile normally 2014-08-07 14:33:09 -07:00
truncindex update go import path and libcontainer 2014-07-24 22:19:50 +00:00
units pkg/units: Updated tests with unit constants 2014-07-26 20:00:18 -07:00
version Fix equal short-long version number comparison 2014-08-11 23:40:35 +02:00
README.md Add README to pkg 2013-12-23 23:12:19 +00:00

pkg/ is a collection of utility packages used by the Docker project without being specific to its internals.

Utility packages are kept separate from the docker core codebase to keep it as small and concise as possible. If some utilities grow larger and their APIs stabilize, they may be moved to their own repository under the Docker organization, to facilitate re-use by other projects. However that is not the priority.

The directory pkg is named after the same directory in the camlistore project. Since Brad is a core Go maintainer, we thought it made sense to copy his methods for organizing Go code :) Thanks Brad!

Because utility packages are small and neatly separated from the rest of the codebase, they are a good place to start for aspiring maintainers and contributors. Get in touch if you want to help maintain them!