usage: fisher search [<plugins>] [--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* ...]<br>
fisher `search` [`--name|--url|--info|--tag|--author`]<br>
fisher `search` [`--query`=*field*[`&&`,`||`]*field*...]<br>
fisher `search` [`--and`] [`--or`] [`--quiet`] [`--help`]<br>

## USAGE

fisher `search` *url*<br>
fisher `search` *name*<br>
fisher `search` *owner/repo*<br>
fisher `search` *query*<br>

## 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
```

* Display plugins by URL, sans *https://github.com/* and format into multiple columns.

```
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)<br>
fisher help plugins<br>