mshex

This is a repository for my personal shell scripts. The name mshex comes from the abbreviation of "my shell extensions". The license is MIT License.

Install

make (GNU make) and gawk (GNU awk) is required. mshex can be installed by the following commands. The scripts and settings will be copied to the install path specified by the make variable PREFIX. The default path for PREFIX is ~/.mwg.

$ git clone git@github.com:akinomyoga/mshex.git
$ cd mshex
$ make install PREFIX=~/.mwg

The common bashrc settings can be loaded by sourcing ~/.mwg/share/mshex/shrc/bashrc_common.sh. To use the external commands of this package, add PREFIX/bin (where PREFIX is the install path) to the environment variable PATH.

# bashrc

# Initialize mshex install prefix
MWGPATH=~/.mwg

# Load common bashrc settings
source "$MWGPATH/share/mshex/shrc/bashrc_common.sh"

# Use mshex external commansds
export PATH=$MWGPATH/bin:$PATH

The list of external commands

The scripts installed in PREFIX/bin is listed here. Please check the output of --help for details of each command.

Source file manipulation

# Find source file names
findsrc [options]
src find [options]

# Grep patterns from the source files
grc [options] pattern [files...]
src grep [options]

# Count LoC
src wc [options]

# Replace tokens in the source files
refact [options] before after [files...]

# Update Makefile from Makefile.pp
makepp

General file manipulation

# Create backup to file.20150101.ext
mwgbk [options] files...

# Rename files with regex (ERE)
ren before after [files...]

# Safe file removes backed up into ~/.recycle
remove [options] files...

# Safe file moves
move [options] file1 file2
move [options] files... dir

# Modify cygwin permissions
modmod [files...]

# Backupped synchronization
msync [options] srcdir dstdir

Copy & run executable files

# Copy and run the executable.
crun executable

# Compile and run program.cxx.
crun program.cxx

Passwords and encryption

# Generate random password
passgen

# Edit ~/.ssh/passwd.cz2
pass --edit

# View ~/.ssh/passwd.cz2
pass

# Encrypt the file
cz file

# Decrypt the file
cz file.cz2

# View contents of the encrypted file
czless file.cz2

Others

# Remove duplicates in ~/.bash_history
hist-uniq [file]

# Filter for text justification (extended fold)
ifold [options]

# Create archive
tarc archive files...

# Show IO activities of the system
iostat.sh

The list of aliases and functions by shrc/bashrc_common.sh

Job control

• Alias j: jobs
• Alias f: fg
• Alias F: fg %-
• Alias NUM: fg %NUM
• Key-binding M-z: fg
• Key-binding C-z: fg
• Key-binding C-NUM: fg %NUM

Change directory

• Alias c: cd - (goto previous directory)
• Alias C: cd .. (goto parent directory)
• Key-binding next: show menu for cd history
• Key-binding M-up: goto the previous entry in cd history
• Key-binding M-down: goto the next entry in cd history

Devel

• Alias m: make in the appropriate directory
• Function g: git manipulations
  • Function g: git status
  • Function g d: diff "working tree" vs "index" (git diff)
  • Function g d0: diff "index" vs "HEAD" (git diff --cached)
  • Function g d[NUM]: diff "NUM-th last commit" vs "its previous commit" (git diff @~((NUM-1)) @~NUM)
  • Function g d COMMIT: diff "the specified commit" vs "its previous commit" (git diff COMMIT~1 COMMIT)
  • Function g t: show commit graph (git log --graph ...)
  • Function g set-mtime: set timestamp of each tracked file to that of the last commit that changed the file
  • Function g ...: other git commands (git "$@")

Others

• Function rmgomi: rm -rf gomi
• Alias o: open file with an appropriate program (cygstart, xdg-open, open, etc.)
• Alias p: show processes (ps uaxf)
• Alias h: show recent command history
• Alias d: show date and calendar
• Alias a: simple calculation command (using gawk)
• Alias s: stty sane
• Alias v: view file
• Alias l: ls -lB
• Alias ll: ls -l
• Alias la: ls -la
• Alias ls, diff, grep: color options
• Alias cp, rm, mv, scp: clobber options
• Alias yes: check stdout
• Function mshex/display: reset the environment variable DISPLAY for the latest SSH session.
• Function mshex/set-prompt: set prompt
• Function mshex/set-window-title: set window title in prompt

Also, bash_common.sh changes the settings for history, tty, checkwinsize, TRAPERR, LANG, etc.

PATH manipulation

These functions are defined in PREFIX/share/mshex/shrc/path.sh.

SYNOPSIS

  PATH.canonicalize [-v VARNAME] [-F SEP]
  PATH.prepend      [-v VARNAME] [-F SEP] [-n] PATHS...
  PATH.append       [-v VARNAME] [-F SEP] [-n] PATHS...
  PATH.remove       [-v VARNAME] [-F SEP] PATHS...
  PATH.show         [VARNAME]

OPTIONS

  -v VARNAME  Change the target variable name. The default is PATH.
  -F SEP      Change the path separater. The default is colon (:).
  -n          Do not add non-existent path.