fisher/man/man1/fisher-search.md
2016-02-27 11:25:16 +08:00

2.6 KiB

fisher-search(1) -- Search Plugin Index

SYNOPSIS

fisher search [plugins ...]
fisher search [--name|--url|--info|--tag|--author]
fisher search [--query=field[&&,||]field...]
fisher search [--format=oneline|short|verbose|longline] [--no-color]
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 plugin name and info. * is shown if plugin is installed.

For example:

  name         info

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

OPTIONS

  • --<field>[=match]: Display index records where field equals 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 using Regular Expressions instead of exact matching. Use !~ to negate the query.

  • --format=oneline|short|verbose|longline: Use the given format to display search results.

  • --no-color: Turn off color display.

  • -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

To allow for easier parsing, Search will print results records in the same line when using one or more of the following options: --name, --url, --info, --tags, --author.

fisher search shark --name --url --author

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

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

EXAMPLES

  • Display plugins by name and format the result into multiple columns.
fisher search --name | column
fisher search --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