From 25070f0bb4f922c38086a6b62207611a583f109d Mon Sep 17 00:00:00 2001 From: francoism90 Date: Tue, 9 May 2023 11:33:12 +0200 Subject: [PATCH] Add podman-compose --- plugins/podman-compose/README.md | 33 ++ plugins/podman-compose/_podman-compose | 421 ++++++++++++++++++ .../podman-compose/podman-compose.plugin.zsh | 24 + 3 files changed, 478 insertions(+) create mode 100644 plugins/podman-compose/README.md create mode 100644 plugins/podman-compose/_podman-compose create mode 100644 plugins/podman-compose/podman-compose.plugin.zsh diff --git a/plugins/podman-compose/README.md b/plugins/podman-compose/README.md new file mode 100644 index 000000000..9f2703d50 --- /dev/null +++ b/plugins/podman-compose/README.md @@ -0,0 +1,33 @@ +# Podman-compose + +This plugin provides completion for [podman-compose](https://github.com/containers/podman-compose) as well as some aliases for frequent podman-compose commands. + +To use it, add podman-compose to the plugins array of your zshrc file: + +```zsh +plugins=(... podman-compose) +``` + +## Aliases + +| Alias | Command | Description | +|-----------|--------------------------------|----------------------------------------------------------------------------------| +| pco | `podman-compose` | Podman-compose main command | +| pcb | `podman-compose build` | Build containers | +| pce | `podman-compose exec` | Execute command inside a container | +| pcps | `podman-compose ps` | List containers | +| pcrestart | `podman-compose restart` | Restart container | +| pcrm | `podman-compose rm` | Remove container | +| pcr | `podman-compose run` | Run a command in container | +| pcstop | `podman-compose stop` | Stop a container | +| pcup | `podman-compose up` | Build, (re)create, start, and attach to containers for a service | +| pcupb | `podman-compose up --build` | Same as `pcup`, but build images before starting containers | +| pcupd | `podman-compose up -d` | Same as `pcup`, but starts as daemon | +| pcupdb | `podman-compose up -d --build` | Same as `pcup`, but build images before starting containers and starts as daemon | +| pcdn | `podman-compose down` | Stop and remove containers | +| pcl | `podman-compose logs` | Show logs of container | +| pclf | `podman-compose logs -f` | Show logs and follow output | +| pcpull | `podman-compose pull` | Pull image of a service | +| pcstart | `podman-compose start` | Start a container | +| pcpause | `podman-compose pause` | Pause a container | +| pck | `podman-compose kill` | Kills containers | diff --git a/plugins/podman-compose/_podman-compose b/plugins/podman-compose/_podman-compose new file mode 100644 index 000000000..e24aa8cd5 --- /dev/null +++ b/plugins/podman-compose/_podman-compose @@ -0,0 +1,421 @@ +#compdef podman-compose + +# Description +# ----------- +# zsh completion for podman-compose +# ------------------------------------------------------------------------- +# Authors +# ------- +# * Steve Durrheimer +# ------------------------------------------------------------------------- +# Inspiration +# ----------- +# * @albers podman-compose bash completion script +# * @felixr podman zsh completion script : https://github.com/felixr/podman-zsh-completion +# ------------------------------------------------------------------------- + +__podman-compose_q() { + podman-compose 2>/dev/null $compose_options "$@" +} + +# All services defined in podman-compose.yml +__podman-compose_all_services_in_compose_file() { + local already_selected + local -a services + already_selected=$(echo $words | tr " " "|") + __podman-compose_q ps --services "$@" \ + | grep -Ev "^(${already_selected})$" +} + +# All services, even those without an existing container +__podman-compose_services_all() { + [[ $PREFIX = -* ]] && return 1 + integer ret=1 + services=$(__podman-compose_all_services_in_compose_file "$@") + _alternative "args:services:($services)" && ret=0 + + return ret +} + +# All services that are defined by a Dockerfile reference +__podman-compose_services_from_build() { + [[ $PREFIX = -* ]] && return 1 + __podman-compose_services_all --filter source=build +} + +# All services that are defined by an image +__podman-compose_services_from_image() { + [[ $PREFIX = -* ]] && return 1 + __podman-compose_services_all --filter source=image +} + +__podman-compose_pausedservices() { + [[ $PREFIX = -* ]] && return 1 + __podman-compose_services_all --filter status=paused +} + +__podman-compose_stoppedservices() { + [[ $PREFIX = -* ]] && return 1 + __podman-compose_services_all --filter status=stopped +} + +__podman-compose_runningservices() { + [[ $PREFIX = -* ]] && return 1 + __podman-compose_services_all --filter status=running +} + +__podman-compose_services() { + [[ $PREFIX = -* ]] && return 1 + __podman-compose_services_all +} + +__podman-compose_caching_policy() { + oldp=( "$1"(Nmh+1) ) # 1 hour + (( $#oldp )) +} + +__podman-compose_commands() { + local cache_policy + + zstyle -s ":completion:${curcontext}:" cache-policy cache_policy + if [[ -z "$cache_policy" ]]; then + zstyle ":completion:${curcontext}:" cache-policy __podman-compose_caching_policy + fi + + if ( [[ ${+_podman_compose_subcommands} -eq 0 ]] || _cache_invalid podman_compose_subcommands) \ + && ! _retrieve_cache podman_compose_subcommands; + then + local -a lines + lines=(${(f)"$(_call_program commands podman-compose 2>&1)"}) + _podman_compose_subcommands=(${${${lines[$((${lines[(i)Commands:]} + 1)),${lines[(I) *]}]}## #}/ ##/:}) + (( $#_podman_compose_subcommands > 0 )) && _store_cache podman_compose_subcommands _podman_compose_subcommands + fi + _describe -t podman-compose-commands "podman-compose command" _podman_compose_subcommands +} + +__podman-compose_subcommand() { + local opts_help opts_force_recreate opts_no_recreate opts_no_build opts_remove_orphans opts_timeout opts_no_color opts_no_deps + + opts_help='(: -)--help[Print usage]' + opts_force_recreate="(--no-recreate)--force-recreate[Recreate containers even if their configuration and image haven't changed. Incompatible with --no-recreate.]" + opts_no_recreate="(--force-recreate)--no-recreate[If containers already exist, don't recreate them. Incompatible with --force-recreate.]" + opts_no_build="(--build)--no-build[Don't build an image, even if it's missing.]" + opts_remove_orphans="--remove-orphans[Remove containers for services not defined in the Compose file]" + opts_timeout=('(-t --timeout)'{-t,--timeout}"[Specify a shutdown timeout in seconds. (default: 10)]:seconds: ") + opts_no_color='--no-color[Produce monochrome output.]' + opts_no_deps="--no-deps[Don't start linked services.]" + + integer ret=1 + + case "$words[1]" in + (build) + _arguments \ + $opts_help \ + "*--build-arg=[Set build-time variables for one service.]:=: " \ + '--force-rm[Always remove intermediate containers.]' \ + '(--quiet -q)'{--quiet,-q}'[Curb build output]' \ + '(--memory -m)'{--memory,-m}'[Memory limit for the build container.]' \ + '--no-cache[Do not use cache when building the image.]' \ + '--pull[Always attempt to pull a newer version of the image.]' \ + '--compress[Compress the build context using gzip.]' \ + '--parallel[Build images in parallel.]' \ + '*:services:__podman-compose_services_from_build' && ret=0 + ;; + (config) + _arguments \ + $opts_help \ + '(--quiet -q)'{--quiet,-q}"[Only validate the configuration, don't print anything.]" \ + '--resolve-image-digests[Pin image tags to digests.]' \ + '--services[Print the service names, one per line.]' \ + '--volumes[Print the volume names, one per line.]' \ + '--hash[Print the service config hash, one per line. Set "service1,service2" for a list of specified services.]' \ && ret=0 + ;; + (create) + _arguments \ + $opts_help \ + $opts_force_recreate \ + $opts_no_recreate \ + $opts_no_build \ + "(--no-build)--build[Build images before creating containers.]" \ + '*:services:__podman-compose_services' && ret=0 + ;; + (down) + _arguments \ + $opts_help \ + $opts_timeout \ + "--rmi[Remove images. Type must be one of: 'all': Remove all images used by any service. 'local': Remove only images that don't have a custom tag set by the \`image\` field.]:type:(all local)" \ + '(-v --volumes)'{-v,--volumes}"[Remove named volumes declared in the \`volumes\` section of the Compose file and anonymous volumes attached to containers.]" \ + $opts_remove_orphans && ret=0 + ;; + (events) + _arguments \ + $opts_help \ + '--json[Output events as a stream of json objects]' \ + '*:services:__podman-compose_services' && ret=0 + ;; + (exec) + _arguments \ + $opts_help \ + '-d[Detached mode: Run command in the background.]' \ + '--privileged[Give extended privileges to the process.]' \ + '(-u --user)'{-u,--user=}'[Run the command as this user.]:username:_users' \ + '-T[Disable pseudo-tty allocation. By default `podman-compose exec` allocates a TTY.]' \ + '--index=[Index of the container if there are multiple instances of a service \[default: 1\]]:index: ' \ + '*'{-e,--env}'[KEY=VAL Set an environment variable (can be used multiple times)]:environment variable KEY=VAL: ' \ + '(-w --workdir)'{-w,--workdir=}'[Working directory inside the container]:workdir: ' \ + '(-):running services:__podman-compose_runningservices' \ + '(-):command: _command_names -e' \ + '*::arguments: _normal' && ret=0 + ;; + (help) + _arguments ':subcommand:__podman-compose_commands' && ret=0 + ;; + (images) + _arguments \ + $opts_help \ + '-q[Only display IDs]' \ + '*:services:__podman-compose_services' && ret=0 + ;; + (kill) + _arguments \ + $opts_help \ + '-s[SIGNAL to send to the container. Default signal is SIGKILL.]:signal:_signals' \ + '*:running services:__podman-compose_runningservices' && ret=0 + ;; + (logs) + _arguments \ + $opts_help \ + '(-f --follow)'{-f,--follow}'[Follow log output]' \ + $opts_no_color \ + '--tail=[Number of lines to show from the end of the logs for each container.]:number of lines: ' \ + '(-t --timestamps)'{-t,--timestamps}'[Show timestamps]' \ + '*:services:__podman-compose_services' && ret=0 + ;; + (pause) + _arguments \ + $opts_help \ + '*:running services:__podman-compose_runningservices' && ret=0 + ;; + (port) + _arguments \ + $opts_help \ + '--protocol=[tcp or udp \[default: tcp\]]:protocol:(tcp udp)' \ + '--index=[index of the container if there are multiple instances of a service \[default: 1\]]:index: ' \ + '1:running services:__podman-compose_runningservices' \ + '2:port:_ports' && ret=0 + ;; + (ps) + _arguments \ + $opts_help \ + '-q[Only display IDs]' \ + '--filter KEY=VAL[Filter services by a property]:=:' \ + '*:services:__podman-compose_services' && ret=0 + ;; + (pull) + _arguments \ + $opts_help \ + '--ignore-pull-failures[Pull what it can and ignores images with pull failures.]' \ + '--no-parallel[Disable parallel pulling]' \ + '(-q --quiet)'{-q,--quiet}'[Pull without printing progress information]' \ + '--include-deps[Also pull services declared as dependencies]' \ + '*:services:__podman-compose_services_from_image' && ret=0 + ;; + (push) + _arguments \ + $opts_help \ + '--ignore-push-failures[Push what it can and ignores images with push failures.]' \ + '*:services:__podman-compose_services' && ret=0 + ;; + (rm) + _arguments \ + $opts_help \ + '(-f --force)'{-f,--force}"[Don't ask to confirm removal]" \ + '-v[Remove any anonymous volumes attached to containers]' \ + '*:stopped services:__podman-compose_stoppedservices' && ret=0 + ;; + (run) + _arguments \ + $opts_help \ + $opts_no_deps \ + '-d[Detached mode: Run container in the background, print new container name.]' \ + '*-e[KEY=VAL Set an environment variable (can be used multiple times)]:environment variable KEY=VAL: ' \ + '*'{-l,--label}'[KEY=VAL Add or override a label (can be used multiple times)]:label KEY=VAL: ' \ + '--entrypoint[Overwrite the entrypoint of the image.]:entry point: ' \ + '--name=[Assign a name to the container]:name: ' \ + '(-p --publish)'{-p,--publish=}"[Publish a container's port(s) to the host]" \ + '--rm[Remove container after run. Ignored in detached mode.]' \ + "--service-ports[Run command with the service's ports enabled and mapped to the host.]" \ + '-T[Disable pseudo-tty allocation. By default `podman-compose run` allocates a TTY.]' \ + '(-u --user)'{-u,--user=}'[Run as specified username or uid]:username or uid:_users' \ + '(-v --volume)*'{-v,--volume=}'[Bind mount a volume]:volume: ' \ + '(-w --workdir)'{-w,--workdir=}'[Working directory inside the container]:workdir: ' \ + "--use-aliases[Use the services network aliases in the network(s) the container connects to]" \ + '(-):services:__podman-compose_services' \ + '(-):command: _command_names -e' \ + '*::arguments: _normal' && ret=0 + ;; + (scale) + _arguments \ + $opts_help \ + $opts_timeout \ + '*:running services:__podman-compose_runningservices' && ret=0 + ;; + (start) + _arguments \ + $opts_help \ + '*:stopped services:__podman-compose_stoppedservices' && ret=0 + ;; + (stop|restart) + _arguments \ + $opts_help \ + $opts_timeout \ + '*:running services:__podman-compose_runningservices' && ret=0 + ;; + (top) + _arguments \ + $opts_help \ + '*:running services:__podman-compose_runningservices' && ret=0 + ;; + (unpause) + _arguments \ + $opts_help \ + '*:paused services:__podman-compose_pausedservices' && ret=0 + ;; + (up) + _arguments \ + $opts_help \ + '(--abort-on-container-exit)-d[Detached mode: Run containers in the background, print new container names. Incompatible with --abort-on-container-exit and --attach-dependencies.]' \ + $opts_no_color \ + $opts_no_deps \ + $opts_force_recreate \ + $opts_no_recreate \ + $opts_no_build \ + "(--no-build)--build[Build images before starting containers.]" \ + "(-d)--abort-on-container-exit[Stops all containers if any container was stopped. Incompatible with -d.]" \ + "(-d)--attach-dependencies[Attach to dependent containers. Incompatible with -d.]" \ + '(-t --timeout)'{-t,--timeout}"[Use this timeout in seconds for container shutdown when attached or when containers are already running. (default: 10)]:seconds: " \ + '--scale[SERVICE=NUM Scale SERVICE to NUM instances. Overrides the `scale` setting in the Compose file if present.]:service scale SERVICE=NUM: ' \ + '--exit-code-from=[Return the exit code of the selected service container. Implies --abort-on-container-exit]:service:__podman-compose_services' \ + $opts_remove_orphans \ + '*:services:__podman-compose_services' && ret=0 + ;; + (version) + _arguments \ + $opts_help \ + "--short[Shows only Compose's version number.]" && ret=0 + ;; + (*) + _message 'Unknown sub command' && ret=1 + ;; + esac + + return ret +} + +_podman-compose() { + # Support for subservices, which allows for `compdef _podman podman-shell=_podman_containers`. + # Based on /usr/share/zsh/functions/Completion/Unix/_git without support for `ret`. + if [[ $service != podman-compose ]]; then + _call_function - _$service + return + fi + + local curcontext="$curcontext" state line + integer ret=1 + typeset -A opt_args + + local file_description + + if [[ -n ${words[(r)-f]} || -n ${words[(r)--file]} ]] ; then + file_description="Specify an override podman-compose file (default: podman-compose.override.yml)" + else + file_description="Specify an alternate podman-compose file (default: podman-compose.yml)" + fi + + _arguments -C \ + '(- :)'{-h,--help}'[Get help]' \ + '*'{-f,--file}"[${file_description}]:file:_files -g '*.yml'" \ + '(-p --project-name)'{-p,--project-name}'[Specify an alternate project name (default: directory name)]:project name:' \ + '--env-file[Specify an alternate environment file (default: .env)]:env-file:_files' \ + "--compatibility[If set, Compose will attempt to convert keys in v3 files to their non-Swarm equivalent]" \ + '(- :)'{-v,--version}'[Print version and exit]' \ + '--verbose[Show more output]' \ + '--log-level=[Set log level]:level:(DEBUG INFO WARNING ERROR CRITICAL)' \ + '--no-ansi[Do not print ANSI control characters]' \ + '--ansi=[Control when to print ANSI control characters]:when:(never always auto)' \ + '(-H --host)'{-H,--host}'[Daemon socket to connect to]:host:' \ + '--tls[Use TLS; implied by --tlsverify]' \ + '--tlscacert=[Trust certs signed only by this CA]:ca path:' \ + '--tlscert=[Path to TLS certificate file]:client cert path:' \ + '--tlskey=[Path to TLS key file]:tls key path:' \ + '--tlsverify[Use TLS and verify the remote]' \ + "--skip-hostname-check[Don't check the daemon's hostname against the name specified in the client certificate (for example if your podman host is an IP address)]" \ + '(-): :->command' \ + '(-)*:: :->option-or-argument' && ret=0 + + local -a relevant_compose_flags relevant_compose_repeatable_flags relevant_podman_flags compose_options podman_options + + relevant_compose_flags=( + "--env-file" + "--file" "-f" + "--host" "-H" + "--project-name" "-p" + "--tls" + "--tlscacert" + "--tlscert" + "--tlskey" + "--tlsverify" + "--skip-hostname-check" + ) + + relevant_compose_repeatable_flags=( + "--file" "-f" + ) + + relevant_podman_flags=( + "--host" "-H" + "--tls" + "--tlscacert" + "--tlscert" + "--tlskey" + "--tlsverify" + ) + + for k in "${(@k)opt_args}"; do + if [[ -n "${relevant_podman_flags[(r)$k]}" ]]; then + podman_options+=$k + if [[ -n "$opt_args[$k]" ]]; then + podman_options+=$opt_args[$k] + fi + fi + if [[ -n "${relevant_compose_flags[(r)$k]}" ]]; then + if [[ -n "${relevant_compose_repeatable_flags[(r)$k]}" ]]; then + values=("${(@s/:/)opt_args[$k]}") + for value in $values + do + compose_options+=$k + compose_options+=$value + done + else + compose_options+=$k + if [[ -n "$opt_args[$k]" ]]; then + compose_options+=$opt_args[$k] + fi + fi + fi + done + + case $state in + (command) + __podman-compose_commands && ret=0 + ;; + (option-or-argument) + curcontext=${curcontext%:*:*}:podman-compose-$words[1]: + __podman-compose_subcommand && ret=0 + ;; + esac + + return ret +} + +_podman-compose "$@" diff --git a/plugins/podman-compose/podman-compose.plugin.zsh b/plugins/podman-compose/podman-compose.plugin.zsh new file mode 100644 index 000000000..1316f5c6b --- /dev/null +++ b/plugins/podman-compose/podman-compose.plugin.zsh @@ -0,0 +1,24 @@ +# support Compose v2 as podman CLI plugin +(( ${+commands[podman-compose]} )) && pccmd='podman-compose' || pccmd='podman compose' + +alias pco="$pccmd" +alias pcb="$pccmd build" +alias pce="$pccmd exec" +alias pcps="$pccmd ps" +alias pcrestart="$pccmd restart" +alias pcrm="$pccmd rm" +alias pcr="$pccmd run" +alias pcstop="$pccmd stop" +alias pcup="$pccmd up" +alias pcupb="$pccmd up --build" +alias pcupd="$pccmd up -d" +alias pcupdb="$pccmd up -d --build" +alias pcdn="$pccmd down" +alias pcl="$pccmd logs" +alias pclf="$pccmd logs -f" +alias pcpull="$pccmd pull" +alias pcstart="$pccmd start" +alias pcpause="$pccmd pause" +alias pck="$pccmd kill" + +unset pccmd