mirror of https://github.com/jorgebucaran/fisher synced 2024-07-02 23:11:48 +02:00

Notable changes:

+ Now fisher list does not show plugins that are disabled,
  but available in the cache. To preview these items use
  fisher list --disabled.

+ Welcome aboard @orangecms and @xrain0610.

+ Fisherman is now available in AUR, thanks @orangecms.

+ Fix load order during installation. Now snippets can
  safely invoke functions defined in the plugin function
  directory. Thanks @orangecms. #170.

+ Fisherman **installs and updates plugins ⌁concurrently**.
  Performance may vary, but if you can see 5 to 10 times
  faster network times, it's working well.

2016-03-31 02:42:44 +09:00

3.1 KiB

Raw Blame History

fisher-search(1) -- Search plugin index

SYNOPSIS

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

USAGE

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

DESCRIPTION

Search plugins in the Fisherman index.

fisher search
  ...
* debug        Conditional debug logger
  errno        POSIX error code/string translator
* fishtape     TAP producing test runner
  flash        Flash-inspired, thunder prompt
  fzf          Efficient keybindings for fzf
  get          Press any key to continue
  ...
> superman     Powerline prompt based on Superman
  ...

Get detailed information about a plugin.

fisher search superman
> superman by bucaran
Powerline prompt based on Superman
github.com/fishery/superman

Search plugins using tags.

fisher search --tag={git,test}
  ...
* fishtape           TAP producing test runner
  git-branch-name    Get the name of the current Git branch
  git-is-repo        Test if the current directory is a Git repo
  git-is-dirty       Test if there are changes not staged for commit
  git-is-stashed     Test if there are changes in the stash
  ...

The legend consists of:

* Indicate the plugin is currently installed
> Indicate the plugin is a prompt
@ Indicate the plugin is a symbolic link

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[=match], but using Regular Expressions. Use !~ to negate the query.
--long: Display results in long format.
--full: Display results in full format.
--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.

RESULTS

Search prints results records in the same line, when using one or more of the following options: --name, --url, --info, --tags, --author. This allows you to parse search results easily.

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

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

EXAMPLES

Display plugins by name and format the result into multiple columns.

fisher search --name | column

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

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/

3.1 KiB Raw Blame History