stow/oh-my-zsh/.oh-my-zsh/plugins/singlechar/README.md

   1 # Singlechar plugin
   2
   3 This plugin adds single char shortcuts (and combinations) for some commands.
   4
   5 To use it, add `singlechar` to the plugins array of your zshrc file:
   6 ```
   7 plugins=(... singlechar)
   8 ```
   9
  10 ## Aliases
  11
  12 ### CAT, GREP, CURL, WGET
  13
  14 | Alias | Command          | Description |
  15 |-------|------------------|-------------|
  16 | y     | `grep -Ri`       | Find case-insensitive string in all files and directories, recursively. Follows symlinks. |
  17 | n     | `grep -Rvi`      | Same as above but only show lines that don't match the string.                            |
  18 | f     | `grep -Rli`      | Same as 'y' but only print the filenames where the string is found.                       |
  19 | fn    | `grep -Rlvi`     | Same as above but only show files that don't contain the string.                          |
  20 | f.    | `find . \| grep` | Grep list of files in current directory                                                   |
  21 | f:    | `find`           | 'find' command                                                                            |
  22 | p     | `less`           | 'less' command                                                                            |
  23 | m     | `man`            | 'man' command                                                                             |
  24 | d     | `wget`           | 'wget' command                                                                            |
  25 | u     | `curl`           | 'curl' command                                                                            |
  26 | c     | `cat`            | 'cat' command                                                                             |
  27 | w     | `echo >`         | Write arguments to file, overwriting it if it exists.                                     |
  28 | a     | `echo >>`        | Write arguments to file, appending them if the file exists.                               |
  29 | w:    | `cat >`          | Write stdin to file, overwriting if it exists.                                            |
  30 | a:    | `cat >>`         | Write stdin to file, appending it if the file exists.                                     |
  31
  32 ### XARGS
  33
  34 These aliases are versions of the aliases above but using xargs. This can be used
  35 by piping the arguments to the xargs aliases.
  36
  37 | Alias | Command              | Description                     |
  38 |-------|----------------------|---------------------------------|
  39 | x     | `xargs`              | 'xargs' command                 |
  40 | xy    | `xargs grep -Ri`     | Same as 'y' alias using xargs.  |
  41 | xn    | `xargs grep -Rvi`    | Same as 'n' alias using xargs.  |
  42 | xf    | `xargs grep -Rli`    | Same as 'f' alias using xargs.  |
  43 | xfn   | `xargs grep -Rlvi`   | Same as 'fn' alias using xargs. |
  44 | xf.   | `xargs find \| grep` | Same as 'f.' alias using xargs. |
  45 | xf:   | `xargs find`         | Same as 'f:' alias using xargs. |
  46 | xc    | `xargs cat`          | Same as 'c' alias using xargs.  |
  47 | xp    | `xargs less`         | Same as 'p' alias using xargs.  |
  48 | xm    | `xargs man`          | Same as 'm' alias using xargs.  |
  49 | xd    | `xargs wget`         | Same as 'd' alias using xargs.  |
  50 | xu    | `xargs curl`         | Same as 'u' alias using xargs.  |
  51 | xw    | `xargs echo >`       | Same as 'w' alias using xargs.  |
  52 | xa    | `xargs echo >>`      | Same as 'a' alias using xargs.  |
  53 | xw:   | `xargs cat >`        | Same as 'w:' alias using xargs. |
  54 | xa:   | `xargs >>`           | Same as 'a:' alias using xargs. |
  55
  56 ### SUDO
  57
  58 These aliases are versions of the aliases above in [CAT, GREP, CURL, WGET](#cat-grep-curl-wget)
  59 but using sudo to run them with root permission.
  60
  61 | Alias | Command               | Description                    |
  62 |-------|-----------------------|--------------------------------|
  63 | s     | `sudo`                | 'sudo' command                 |
  64 | sy    | `sudo grep -Ri`       | Same as 'y' alias using sudo.  |
  65 | sn    | `sudo grep -Riv`      | Same as 'n' alias using sudo.  |
  66 | sf    | `sudo grep -Rli`      | Same as 'f' alias using sudo.  |
  67 | sfn   | `sudo grep -Rlvi`     | Same as 'fn' alias using sudo. |
  68 | sf.   | `sudo find . \| grep` | Same as 'f.' alias using sudo. |
  69 | sf:   | `sudo find`           | Same as 'f:' alias using sudo. |
  70 | sp    | `sudo less`           | Same as 'p' alias using sudo.  |
  71 | sm    | `sudo man`            | Same as 'm' alias using sudo.  |
  72 | sd    | `sudo wget`           | Same as 'd' alias using sudo.  |
  73 | sc    | `sudo cat`            | Same as 'c' alias using sudo.  |
  74 | sw    | `sudo echo >`         | Same as 'w' alias using sudo.  |
  75 | sa    | `sudo echo >>`        | Same as 'a' alias using sudo.  |
  76 | sw:   | `sudo cat >`          | Same as 'w:' alias using sudo. |
  77 | sa:   | `sudo cat >>`         | Same as 'a:' alias using sudo. |
  78
  79 ### SUDO-XARGS
  80
  81 Same as above but using both sudo and xargs.
  82
  83 | Alias | Command                   | Description                     |
  84 |-------|---------------------------|---------------------------------|
  85 | sx    | `sudo xargs`              | 'sudo xargs' command            |
  86 | sxy   | `sudo xargs grep -Ri`     | Same as 'xy' alias using sudo.  |
  87 | sxn   | `sudo xargs grep -Riv`    | Same as 'xn' alias using sudo.  |
  88 | sxf   | `sudo xargs grep -li`     | Same as 'xf' alias using sudo.  |
  89 | sxfn  | `sudo xargs grep -lvi`    | Same as 'xfn' alias using sudo. |
  90 | sxf.  | `sudo xargs find \| grep` | Same as 'xf.' alias using sudo. |
  91 | sxf:  | `sudo xargs find`         | Same as 'xf:' alias using sudo. |
  92 | sxp   | `sudo xargs less`         | Same as 'xp' alias using sudo.  |
  93 | sxm   | `sudo xargs man`          | Same as 'xm' alias using sudo.  |
  94 | sxd   | `sudo xargs wget`         | Same as 'xd' alias using sudo.  |
  95 | sxu   | `sudo xargs curl`         | Same as 'xu' alias using sudo.  |
  96 | sxc   | `sudo xargs cat`          | Same as 'xc' alias using sudo.  |
  97 | sxw   | `sudo xargs echo >`       | Same as 'xw' alias using sudo.  |
  98 | sxa   | `sudo xargs echo >>`      | Same as 'xa' alias using sudo.  |
  99 | sxw:  | `sudo xargs cat >`        | Same as 'xw:' alias using sudo. |
 100 | sxa:  | `sudo xargs cat >>`       | Same as 'xa:' alias using sudo. |
 101
 102 ## Options
 103
 104 The commands `grep`, `sudo`, `wget`, `curl`, and `less` can be configured to use other commands
 105 via the setup variables below, before Oh My Zsh is sourced. If they are not set yet, they will
 106 use their default values:
 107
 108 | Setup variable | Default value |
 109 |----------------|---------------|
 110 | GREP           | `grep`        |
 111 | ROOT           | `sudo`        |
 112 | WGET           | `wget`        |
 113 | CURL           | `curl`        |
 114 | PAGER          | `less`        |
 115
 116 ## Author
 117
 118 - [Karolin Varner](https://github.com/koraa)