command: docker search
short: Search the Docker Hub for images
long: |
  Search Docker Hub for images that match the specified `TERM`. The table
  of images returned displays the name, description (truncated by default), number
  of stars awarded, whether the image is official, and whether it is automated.

  *Note* - Search queries will only return up to 25 results

  ## Filter

     Filter output based on these conditions:
     - stars=<numberOfStar>
     - is-automated=(true|false)
     - is-official=(true|false)

  # EXAMPLES

  ## Search Docker Hub for ranked images

  Search a registry for the term 'fedora' and only display those images
  ranked 3 or higher:

      $ docker search --filter=stars=3 fedora
      NAME                  DESCRIPTION                                    STARS OFFICIAL  AUTOMATED
      mattdm/fedora         A basic Fedora image corresponding roughly...  50
      fedora                (Semi) Official Fedora base image.             38
      mattdm/fedora-small   A small Fedora image on which to build. Co...  8
      goldmann/wildfly      A WildFly application server running on a ...  3               [OK]

  ## Search Docker Hub for automated images

  Search Docker Hub for the term 'fedora' and only display automated images
  ranked 1 or higher:

      $ docker search --filter=is-automated=true --filter=stars=1 fedora
      NAME               DESCRIPTION                                     STARS OFFICIAL  AUTOMATED
      goldmann/wildfly   A WildFly application server running on a ...   3               [OK]
      tutum/fedora-20    Fedora 20 image with SSH access. For the r...   1               [OK]
usage: docker search [OPTIONS] TERM
pname: docker
plink: docker.yaml
options:
- option: automated
  default_value: "false"
  description: Only show automated builds
- option: filter
  shorthand: f
  description: Filter output based on conditions provided
- option: limit
  default_value: "25"
  description: Max number of search results
- option: no-trunc
  default_value: "false"
  description: Don't truncate output
- option: stars
  shorthand: s
  default_value: "0"
  description: Only displays with at least x stars