xp
v1.0.1
Published
Command line regular expression search and replace
Downloads
54
Maintainers
Readme
XP
Search and replace on the command line using Javscript regular expressions.
A handy replacement to sed
.
$ npm install -g xp
Usage: xp [-ialo] <search pattern> [replace pattern] [--] [files...]
Options:
-h, --help output usage information
-V, --version output the version number
-i, --insensitive perform case-insensitive searching
-a, --all perform search (and replace) on whole input
-l, --lines show the filename and line number for matches
-O, --only-matching-lines show only the lines that match
-o, --only-matching show only the portion of the search text that matched
<search_pattern> the search pattern
[replace_pattern] the replacement pattern
[files...] one or more files to read
Remarks:
The search pattern defaults to line-by-line matching by default.
Specifying `-a' will cause the input to be matched in whole (inverse of the /.../m
flag), though will cause the entire input to be buffered in memory prior to
performing a match.
If no replacement pattern is provided, and filenames are to be specified, `--' must
come after the search pattern and before the command line arguments. It is innocuous
to have it when using both a replacement pattern and a list of files.
If no files are specified, or if a single hyphen (`-') is specified as a file, then
standard input is read instead.
The `--lines' flag only applies when `-a' is not specified and no replacement is
being performed.
The `--only-matching` flag only applies when no replacement is being performed.
Bugs:
For bug reports, updates, issues or feedback, please file an issue on GitHub:
https://github.com/qix-/xp
Examples
$ echo 'hello' | xp -o .
h
e
l
l
o
$ echo 'hello' | xp h j
jello
$ cat /usr/share/dict/propernames | xp -O 'Jean\-([A-Z][a-z]*)' 'Jean clan: $1'
Jean clan: Christophe
Jean clan: Pierre
License
Licensed under the MIT License. You can find a copy of it in LICENSE.