mirror of
https://github.com/chmln/sd
synced 2024-11-22 11:13:04 +00:00
4f77cfe1b8
* Add replacements tests * Honor `-n` when using `--preview` * Rework CLI for replacements flag * Remove dead code * Remove lingering TODO
95 lines
2.5 KiB
Groff
95 lines
2.5 KiB
Groff
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.TH sd 1 "sd 0.7.6"
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.SH NAME
|
|
sd
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.SH SYNOPSIS
|
|
\fBsd\fR [\fB\-p\fR|\fB\-\-preview\fR] [\fB\-F\fR|\fB\-\-fixed\-strings\fR] [\fB\-n\fR|\fB\-\-max\-replacements\fR] [\fB\-f\fR|\fB\-\-flags\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] <\fIFIND\fR> <\fIREPLACE_WITH\fR> [\fIFILES\fR]
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.SH DESCRIPTION
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB\-p\fR, \fB\-\-preview\fR
|
|
Display changes in a human reviewable format (the specifics of the format are likely to change in the future)
|
|
.TP
|
|
\fB\-F\fR, \fB\-\-fixed\-strings\fR
|
|
Treat FIND and REPLACE_WITH args as literal strings
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-max\-replacements\fR=\fILIMIT\fR [default: 0]
|
|
Limit the number of replacements that can occur per file. 0 indicates unlimited replacements
|
|
.TP
|
|
\fB\-f\fR, \fB\-\-flags\fR=\fIFLAGS\fR
|
|
Regex flags. May be combined (like `\-f mc`).
|
|
|
|
c \- case\-sensitive
|
|
|
|
e \- disable multi\-line matching
|
|
|
|
i \- case\-insensitive
|
|
|
|
m \- multi\-line matching
|
|
|
|
s \- make `.` match newlines
|
|
|
|
w \- match full words only
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
Print help (see a summary with \*(Aq\-h\*(Aq)
|
|
.TP
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
Print version
|
|
.TP
|
|
<\fIFIND\fR>
|
|
The regexp or string (if using `\-F`) to search for
|
|
.TP
|
|
<\fIREPLACE_WITH\fR>
|
|
What to replace each match with. Unless in string mode, you may use captured values like $1, $2, etc
|
|
.TP
|
|
[\fIFILES\fR]
|
|
The path to file(s). This is optional \- sd can also read from STDIN.
|
|
|
|
Note: sd modifies files in\-place by default. See documentation for examples.
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.SH "EXIT STATUS"
|
|
.IP 0
|
|
Successful program execution.
|
|
.IP 1
|
|
Unsuccessful program execution.
|
|
.IP 101
|
|
The program panicked.
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.SH EXAMPLES
|
|
.TP
|
|
String\-literal mode
|
|
\fB$ echo \*(Aqlots((([]))) of special chars\*(Aq | sd \-s \*(Aq((([])))\*(Aq\fR
|
|
.br
|
|
lots of special chars
|
|
.TP
|
|
Regex use. Let\*(Aqs trim some trailing whitespace
|
|
\fB$ echo \*(Aqlorem ipsum 23 \*(Aq | sd \*(Aq\\s+$\*(Aq \*(Aq\*(Aq\fR
|
|
.br
|
|
lorem ipsum 23
|
|
.TP
|
|
Indexed capture groups
|
|
\fB$ echo \*(Aqcargo +nightly watch\*(Aq | sd \*(Aq(\\w+)\\s+\\+(\\w+)\\s+(\\w+)\*(Aq \*(Aqcmd: $1, channel: $2, subcmd: $3\*(Aq\fR
|
|
.br
|
|
123 dollars and 45 cents
|
|
.TP
|
|
Find & replace in file
|
|
\fB$ sd \*(Aqwindow.fetch\*(Aq \*(Aqfetch\*(Aq http.js\fR
|
|
.br
|
|
|
|
.TP
|
|
Find & replace from STDIN an emit to STDOUT
|
|
\fB$ sd \*(Aqwindow.fetch\*(Aq \*(Aqfetch\*(Aq < http.js\fR
|
|
.br
|
|
|