A command-line snippet manager in Go
Forked from https://github.com/tokozedg/sman
- Build with Go
go get -d github.com/tokozedg/sman
git -C "$GOPATH/src/github.com/tokozedg/sman" remote add dhhyi https://github.com/dhhyi/sman.git
git -C "$GOPATH/src/github.com/tokozedg/sman" branch --set-upstream-to dhhyi/master
git -C "$GOPATH/src/github.com/tokozedg/sman" reset --hard
go build -v github.com/tokozedg/sman
- Add to your rc:
[ -f $GOPATH/src/github.com/tokozedg/sman/sman.rc ] && source $GOPATH/src/github.com/tokozedg/sman/sman.rc
- Optionally copy demo snippets dir or create yours:
cp -r $GOPATH/src/github.com/tokozedg/sman/snippets ~/
#~/snippets/shell.yml
smtp:server: # snippet name
do: exec # copy or exec
desc: smtp server in python. Prints mails to stdout
command: python -m smtpd -n -c DebuggingServer localhost:1025
#~/snippets/shell.yml
# Sman will ask input for placeholder <<port>>
tcpdump:port:
do: copy
desc: listen traffic on port
command: tcpdump -nqt -s 0 -A -i eth0 port <<port>>
#~/snippets/shell.yml
# To execute multiline commands, separate lines by semi-colon
curl:upload:
do: exec
command: >
gpg -c <<file>>;
curl --upload-file <<file>>.gpg https://transfer.sh/<<file>>.gpg
- You can export command to a separate file located at:
SMAN_SNIPPET_DIR/<Snippet File Name>/<Snippet Name>
<<name(option1,option2)#Description>>
- Include placeholder anywhere within snippet command
- Name is the only mandatory field
- You can have multiple placeholders with the same name. After input all of them will be replaced
- Use
\
to escape comma in options
s run [-f <FILE>] [-t <TAG>] <SNIPPET> [placeholder values...] [-cxyp]
~|⇒ s run -f shell curl:upload test.tar.gz -x
----
gpg -c test.tar.gz; curl --upload-file test.tar.gz.gpg https://transfer.sh/test.tar.gz.gpg
----
Execute Snippet? [Y/n]:
~|⇒ s run curl:ip
----
curl canhazip.com
----
Execute Snippet? [Y/n]:
s show [-f <FILE>] [-t <TAG>] <SNIPPET>
s ls [-f <FILE>] [-t <TAG>] [<PATTERN>]
-
Pattern is matched against snippet name, command and description
-
Search for multiple tags with a
,
(OR)- and+
(AND)-separated list.+
binds stronger than,
. The query fortag1+tag2,tag3
will return snippets withtag1
andtag2
and also return snippets withtag3
.
- Use the
--porcelain
flag to produce machine-readable output for scripting.
$ s ls service:disable --porcelain
shell service:disable ubuntu disable service on ubuntu
$ s ls add --porcelain | cut -f 2 | xargs echo
vhost:add user:add alias:add sshconfig:add user:group
- The output is
\t
-separated. The colums are:
- Snippet file
- Snippet name
- Tags (
,
-separated) - Description
# `r` is alias for `run`
# matches file `mysql` and snippet `database:dump`
~|⇒ s r -f sql dmp
----
mysqldump -u[user] --lock-tables=[lock] -p[pass] -h [host] [database] > [database].sql
----
[user]:
# Append history can be useful to avoid re-entering all placeholders when you need to change single parameter.
export SMAN_APPEND_HISTORY=false
# Snippet directory
export SMAN_SNIPPET_DIR="~/snippets"
# Ask confirmation before executing
export SMAN_EXEC_CONFIRM=true
# Set shell color of groups in ls, see https://misc.flogisoft.com/bash/tip_colors_and_formatting
export SMAN_LS_COLOR_FILES=1,4,35
# Set minimum match percentage for fuzzy search (default is 0)
SMAN_MIN_MATCH_PERCENTAGE=0.5
Install vim plugin for better snippets colors:
- Pathogen
git clone https://github.com/tokozedg/vim-sman.git ~/.vim/bundle/vim-sman
- vim-plug
Plug 'tokozedg/vim-sman'
- NeoBundle
NeoBundle 'tokozedg/vim-sman'
- Vundle
Plugin 'tokozedg/vim-sman'
If you'd like to contribute, please fork the repository and make changes as you'd like. Pull requests are warmly welcome, especially if you make a good snippet file.