mirror of https://github.com/jorgebucaran/fisher
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.
118 lines
2.8 KiB
Markdown
118 lines
2.8 KiB
Markdown
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>
|