You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
fisher/man/man1/fisher-search.md

2.8 KiB

usage: fisher search [] [--and|--or] [--quiet] [--help]

 --field[=value]  Filter by url, name, info, author or tags
          -o --or  Join query with OR operator
         -a --and  Join query with AND operator
       -q --quiet  Enable quiet mode
        -h --help  Show usage help

fisher-search(1) -- Search Plugin Index

SYNOPSIS

fisher search [plugins ...]
fisher search [--name|--url|--info|--tag|--author]
fisher search [--query=field[&&,||]field...]
fisher search [--and] [--or] [--quiet] [--help]

USAGE

fisher search url
fisher search name
fisher search owner/repo
fisher search query

DESCRIPTION

Search plugins in the Fisherman index.

The index file consists of records separated by blank lines '\n\n' and each record consists of fields separated by a single line '\n'.

For example:

name
url
info
tag1 tag2 tag3 ...
author

See Index in fisher help tour for more information about the index.

OPTIONS

  • --<field>[=match]: Display index records where <field>==match. field can be any of name, url, info, tag/s or author. If match is not given, display only the given field from every record in the index. Use != to negate the query.

  • --<field>[~/regex/]: Same as --<field>[=regex], but with a Regular Expression instead of an exact match. Use !~ to negate the query.

  • -a --and: Join the query with a logical AND operator.

  • -o --or: Join the query with a logical OR operator. This is the default operator.

  • -q --quiet: Enable quiet mode.

  • -h --help: Show help.

OUTPUT

The default behavior is to print the result set to standard output in their original format.

fisher search shark
shark
https://github.com/bucaran/shark
Sparkline Generator
chart tool graph sparkline
bucaran

Search is designed for easy parsing when using the filters: --name, --url, --info, --tags, --author.

fisher search shark --name --url

shark;https://github.com/bucaran/shark

The result set above consists of single line per record, and each record consists of one or more of the given fields separated by a semicolon ';'.

EXAMPLES

  • Display plugins by name and format into multiple columns.
fisher search --name | column
fisher search --field=url | sed 's|https://github.com/||' | column
  • Display remote plugins, i.e, those in the index, but not in the cache.
fisher_search --and --name!=(fisher --list=bare)
  • Search all plugins whose name does not start with the letter s.
fisher search --name!~/^s/

SEE ALSO

fisher(1)
fisher help plugins