README.md
1# Singlechar plugin
2
3This plugin adds single char shortcuts (and combinations) for some commands.
4
5To use it, add `singlechar` to the plugins array of your zshrc file:
6```
7plugins=(... 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
34These aliases are versions of the aliases above but using xargs. This can be used
35by 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
58These aliases are versions of the aliases above in [CAT, GREP, CURL, WGET](#cat-grep-curl-wget)
59but 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
81Same 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
104The commands `grep`, `sudo`, `wget`, `curl`, and `less` can be configured to use other commands
105via the setup variables below, before Oh My Zsh is sourced. If they are not set yet, they will
106use 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)
119