mirror of
https://github.com/ohmyzsh/ohmyzsh.git
synced 2024-12-12 20:21:02 +01:00
singlechar: add README (#8232)
Co-authored-by: Marc Cornellà <marc.cornella@live.com>
This commit is contained in:
otherpaco
Marc Cornellà
parent
f5614d2b3a
commit
8bb9b04469
2 changed files with 119 additions and 11 deletions
118
plugins/singlechar/README.md
Normal file
118
plugins/singlechar/README.md
Normal file
|
|
@ -0,0 +1,118 @@
|
|||
# Singlechar plugin
|
||||
|
||||
This plugin adds single char shortcuts (and combinations) for some commands.
|
||||
|
||||
To use it, add `singlechar` to the plugins array of your zshrc file:
|
||||
```
|
||||
plugins=(... singlechar)
|
||||
```
|
||||
|
||||
## Aliases
|
||||
|
||||
### CAT, GREP, CURL, WGET
|
||||
|
||||
| Alias | Command | Description |
|
||||
|-------|------------------|-------------|
|
||||
| y | `grep -Ri` | Find case-insensitive string in all files and directories, recursively. Follows symlinks. |
|
||||
| n | `grep -Rvi` | Same as above but only show lines that don't match the string. |
|
||||
| f | `grep -Rli` | Same as 'y' but only print the filenames where the string is found. |
|
||||
| fn | `grep -Rlvi` | Same as above but only show files that don't contain the string. |
|
||||
| f. | `find . \| grep` | Grep list of files in current directory |
|
||||
| f: | `find` | 'find' command |
|
||||
| p | `less` | 'less' command |
|
||||
| m | `man` | 'man' command |
|
||||
| d | `wget` | 'wget' command |
|
||||
| u | `curl` | 'curl' command |
|
||||
| c | `cat` | 'cat' command |
|
||||
| w | `echo >` | Write arguments to file, overwriting it if it exists. |
|
||||
| a | `echo >>` | Write arguments to file, appending them if the file exists. |
|
||||
| w: | `cat >` | Write stdin to file, overwriting if it exists. |
|
||||
| a: | `cat >>` | Write stdin to file, appending it if the file exists. |
|
||||
|
||||
### XARGS
|
||||
|
||||
These aliases are versions of the aliases above but using xargs. This can be used
|
||||
by piping the arguments to the xargs aliases.
|
||||
|
||||
| Alias | Command | Description |
|
||||
|-------|----------------------|---------------------------------|
|
||||
| x | `xargs` | 'xargs' command |
|
||||
| xy | `xargs grep -Ri` | Same as 'y' alias using xargs. |
|
||||
| xn | `xargs grep -Rvi` | Same as 'n' alias using xargs. |
|
||||
| xf | `xargs grep -Rli` | Same as 'f' alias using xargs. |
|
||||
| xfn | `xargs grep -Rlvi` | Same as 'fn' alias using xargs. |
|
||||
| xf. | `xargs find \| grep` | Same as 'f.' alias using xargs. |
|
||||
| xf: | `xargs find` | Same as 'f:' alias using xargs. |
|
||||
| xc | `xargs cat` | Same as 'c' alias using xargs. |
|
||||
| xp | `xargs less` | Same as 'p' alias using xargs. |
|
||||
| xm | `xargs man` | Same as 'm' alias using xargs. |
|
||||
| xd | `xargs wget` | Same as 'd' alias using xargs. |
|
||||
| xu | `xargs curl` | Same as 'u' alias using xargs. |
|
||||
| xw | `xargs echo >` | Same as 'w' alias using xargs. |
|
||||
| xa | `xargs echo >>` | Same as 'a' alias using xargs. |
|
||||
| xw: | `xargs cat >` | Same as 'w:' alias using xargs. |
|
||||
| xa: | `xargs >>` | Same as 'a:' alias using xargs. |
|
||||
|
||||
### SUDO
|
||||
|
||||
These aliases are versions of the aliases above in [CAT, GREP, CURL, WGET](#cat-grep-curl-wget)
|
||||
but using sudo to run them with root permission.
|
||||
|
||||
| Alias | Command | Description |
|
||||
|-------|-----------------------|--------------------------------|
|
||||
| s | `sudo` | 'sudo' command |
|
||||
| sy | `sudo grep -Ri` | Same as 'y' alias using sudo. |
|
||||
| sn | `sudo grep -Riv` | Same as 'n' alias using sudo. |
|
||||
| sf | `sudo grep -Rli` | Same as 'f' alias using sudo. |
|
||||
| sfn | `sudo grep -Rlvi` | Same as 'fn' alias using sudo. |
|
||||
| sf. | `sudo find . \| grep` | Same as 'f.' alias using sudo. |
|
||||
| sf: | `sudo find` | Same as 'f:' alias using sudo. |
|
||||
| sp | `sudo less` | Same as 'p' alias using sudo. |
|
||||
| sm | `sudo man` | Same as 'm' alias using sudo. |
|
||||
| sd | `sudo wget` | Same as 'd' alias using sudo. |
|
||||
| sc | `sudo cat` | Same as 'c' alias using sudo. |
|
||||
| sw | `sudo echo >` | Same as 'w' alias using sudo. |
|
||||
| sa | `sudo echo >>` | Same as 'a' alias using sudo. |
|
||||
| sw: | `sudo cat >` | Same as 'w:' alias using sudo. |
|
||||
| sa: | `sudo cat >>` | Same as 'a:' alias using sudo. |
|
||||
|
||||
### SUDO-XARGS
|
||||
|
||||
Same as above but using both sudo and xargs.
|
||||
|
||||
| Alias | Command | Description |
|
||||
|-------|---------------------------|---------------------------------|
|
||||
| sx | `sudo xargs` | 'sudo xargs' command |
|
||||
| sxy | `sudo xargs grep -Ri` | Same as 'xy' alias using sudo. |
|
||||
| sxn | `sudo xargs grep -Riv` | Same as 'xn' alias using sudo. |
|
||||
| sxf | `sudo xargs grep -li` | Same as 'xf' alias using sudo. |
|
||||
| sxfn | `sudo xargs grep -lvi` | Same as 'xfn' alias using sudo. |
|
||||
| sxf. | `sudo xargs find \| grep` | Same as 'xf.' alias using sudo. |
|
||||
| sxf: | `sudo xargs find` | Same as 'xf:' alias using sudo. |
|
||||
| sxp | `sudo xargs less` | Same as 'xp' alias using sudo. |
|
||||
| sxm | `sudo xargs man` | Same as 'xm' alias using sudo. |
|
||||
| sxd | `sudo xargs wget` | Same as 'xd' alias using sudo. |
|
||||
| sxu | `sudo xargs curl` | Same as 'xu' alias using sudo. |
|
||||
| sxc | `sudo xargs cat` | Same as 'xc' alias using sudo. |
|
||||
| sxw | `sudo xargs echo >` | Same as 'xw' alias using sudo. |
|
||||
| sxa | `sudo xargs echo >>` | Same as 'xa' alias using sudo. |
|
||||
| sxw: | `sudo xargs cat >` | Same as 'xw:' alias using sudo. |
|
||||
| sxa: | `sudo xargs cat >>` | Same as 'xa:' alias using sudo. |
|
||||
|
||||
## Options
|
||||
|
||||
The commands `grep`, `sudo`, `wget`, `curl`, and `less` can be configured to use other commands
|
||||
via the setup variables below, before Oh My Zsh is sourced. If they are not set yet, they will
|
||||
use their default values:
|
||||
|
||||
| Setup variable | Default value |
|
||||
|----------------|---------------|
|
||||
| GREP | `grep` |
|
||||
| ROOT | `sudo` |
|
||||
| WGET | `wget` |
|
||||
| CURL | `curl` |
|
||||
| PAGER | `less` |
|
||||
|
||||
## Author
|
||||
|
||||
- [Karolin Varner](https://github.com/koraa)
|
||||
|
|
@ -1,13 +1,3 @@
|
|||
################################################################################
|
||||
# FILE: singlechar.plugin.zsh
|
||||
# DESCRIPTION: oh-my-zsh plugin file.
|
||||
# AUTHOR: Michael Varner (musikmichael@web.de)
|
||||
# VERSION: 1.0.0
|
||||
#
|
||||
# This plugin adds single char shortcuts (and combinations) for some commands.
|
||||
#
|
||||
################################################################################
|
||||
|
||||
###########################
|
||||
# Settings
|
||||
|
||||
|
|
@ -130,4 +120,4 @@ alias sxd='"$ROOT" xargs "$WGET"'
|
|||
alias sxu='"$ROOT" xargs "$CURL"'
|
||||
|
||||
alias sxw:='"$ROOT" xargs cat >'
|
||||
alias sxa:='"$ROOT" xargs cat >>'
|
||||
alias sxa:='"$ROOT" xargs cat >>'
|
||||
|
|
|
|||
Loading…
Reference in a new issue