The Docker CLI
Go to file
Sebastiaan van Stijn 462e08219d
cli/container: use github.com/moby/sys/capability for completions
We used a hard-coded list of capabilities that we copied from containerd,
but the new "capability" package allows use to have a maintained list
of capabilities.

There's likely still some improvements to be made;

First of all, the capability package could provide a function to get the list
of strings.

On the completion-side, we need to consider what format is most convenient;
currently we use the canonical name (uppercase and "CAP_" prefix), however,
tab-completion is case-sensitive by default, so requires the user to type
uppercase letters to filter the list of options.

Bash completion provides a `completion-ignore-case on` option to make completion
case-insensitive (https://askubuntu.com/a/87066), but it looks to be a global
option; the current cobra.CompletionOptions also don't provide this as an option
to be used in the generated completion-script.

Fish completion has `smartcase` (by default?) which matches any case if
all of the input is lowercase.

Zsh does not have a dedicated option, but allows setting matching-rules
(see https://superuser.com/a/1092328).

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2024-10-01 14:01:02 +02:00
.github gha: codeql: minor touch-ups and fixes 2024-09-19 11:09:51 +02:00
cli cli/container: use github.com/moby/sys/capability for completions 2024-10-01 14:01:02 +02:00
cli-plugins plugins: don't panic on Close if PluginServer nil 2024-08-07 14:04:31 +01:00
cmd/docker telemetry: fix early meterprovider shutdown 2024-09-20 01:29:19 +01:00
contrib/completion cli/command/container: stop, restart: rename "--time" to "--timeout" 2024-09-30 09:43:54 +02:00
dockerfiles Dockerfile: update buildx to v0.17.1 2024-09-16 15:01:56 +02:00
docs cli/command/container: stop, restart: rename "--time" to "--timeout" 2024-09-30 09:43:54 +02:00
e2e update to go1.22.7 2024-09-05 17:51:27 +02:00
experimental deprecate experimental graphdriver plugins 2024-06-18 16:47:00 +02:00
hack/otel OTEL collector/prometheus/aspire-dashboard stack for testing purposes 2024-04-30 12:25:19 +00:00
internal/test replace uses of deprecated API types 2024-07-04 15:22:18 +02:00
man Merge pull request #5437 from thaJeztah/remove_deprecated_cors_headers 2024-09-16 13:42:01 +01:00
opts run: fix GetList return empty issue for throttledevice 2024-08-07 02:48:39 +00:00
scripts scripts/build/plugins: don't override CGO_ENABLED set by .variables 2024-09-03 11:49:43 +02:00
service/logs service/logs: use strings.Cut 2022-12-29 15:19:31 +01:00
templates Update go:build comments to go1.21 2024-06-18 12:17:13 +02:00
vendor cli/container: use github.com/moby/sys/capability for completions 2024-10-01 14:01:02 +02:00
.dockerignore validate manpages target 2022-02-25 17:11:17 +01:00
.gitattributes fix: binary file line endings 2024-09-06 10:23:23 +02:00
.gitignore Removed all mentions of "please" from docs and messages 2024-06-11 16:53:40 +02:00
.golangci.yml chore: remove duplicated `govet` linter config 2024-09-11 17:55:43 +08:00
.mailmap update mailmap and AUTHORS 2024-06-20 13:22:11 +02:00
AUTHORS update mailmap and AUTHORS 2024-06-20 13:22:11 +02:00
CONTRIBUTING.md Removed all mentions of "please" from docs and messages 2024-06-11 16:53:40 +02:00
Dockerfile Dockerfile: update compose to v2.29.7 2024-09-20 12:22:39 +02:00
LICENSE Add project files 2017-04-17 17:49:33 -04:00
MAINTAINERS not actually a maintainer 2023-11-10 21:35:15 +01:00
Makefile Makefile: add completion target 2024-07-08 10:58:56 -05:00
NOTICE Removed all mentions of "please" from docs and messages 2024-06-11 16:53:40 +02:00
README.md Removed all mentions of "please" from docs and messages 2024-06-11 16:53:40 +02:00
SECURITY.md add security policy 2024-08-05 11:58:34 +02:00
TESTING.md tweak description of login/logout 2022-04-04 10:44:11 +02:00
VERSION Update `VERSION` file to `v27.3.1-dev` 2024-09-20 11:41:30 +01:00
codecov.yml Drop support for (archived) Compose-on-Kubernetes 2022-02-22 13:47:34 +01:00
docker-bake.hcl update to go1.22.7 2024-09-05 17:51:27 +02:00
docker.Makefile Cleanup of dockerfiles, compose files and env vars 2024-02-13 13:32:45 +00:00
vendor.mod cli/container: use github.com/moby/sys/capability for completions 2024-10-01 14:01:02 +02:00
vendor.sum cli/container: use github.com/moby/sys/capability for completions 2024-10-01 14:01:02 +02:00

README.md

Docker CLI

PkgGoDev Build Status Test Status Go Report Card Codecov

About

This repository is the home of the Docker CLI.

Development

docker/cli is developed using Docker.

Build CLI from source:

docker buildx bake

Build binaries for all supported platforms:

docker buildx bake cross

Build for a specific platform:

docker buildx bake --set binary.platform=linux/arm64 

Build dynamic binary for glibc or musl:

USE_GLIBC=1 docker buildx bake dynbinary 

Run all linting:

docker buildx bake lint shellcheck

Run test:

docker buildx bake test

List all the available targets:

make help

In-container development environment

Start an interactive development environment:

make -f docker.Makefile shell

Brought to you courtesy of our legal counsel. For more context, see the NOTICE document in this repo.

Use and transfer of Docker may be subject to certain restrictions by the United States and other governments.

It is your responsibility to ensure that your use and/or transfer does not violate applicable laws.

For more information, see https://www.bis.doc.gov

Licensing

docker/cli is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.