sd(1)

💅 sd(1) — General Commands Manual, but make it group chat 💅

okay so this is sd(1) from the General Commands Manual, and it's giving find-and-replace main character energy. Bestie, if you've ever wanted to search for a regexp or a literal string and swap it out with something else — while looking cute — this is your moment. 💅✨

---

🌸 NAME 🌸

okay so the name is literally sd — that's the whole NAME section, bestie. Short, iconic, no notes. 💅

🦋 SYNOPSIS 🦋

sd [-p|--preview] [-F|--fixed-strings] [-n|--max-replacements]
[-f|--flags] [-A|--across] [-h|--help] [-V|--version] <FIND>
<REPLACE_WITH> [FILES]

🎀 DESCRIPTION 🎀

okay so this DESCRIPTION section is literally empty — no prose, no deets, just a heading doing abs. 💀 The real tea is in OPTIONS, so scroll with me. 🫶

🌈 OPTIONS 🌈

• -p, --preview — displays changes in a human reviewable format. Heads up: the specifics of that format are likely to change in the future. 👀
• -F, --fixed-strings — treats FIND and REPLACE_WITH args as literal strings. No regex shenanigans, just exact-string energy. 💅
• -n, --max-replacements=LIMIT — [default: 0] limits the number of replacements that can occur per file. 0 indicates unlimited replacements, so 0 is the no-cap setting, fr fr. 🔥
• -f, --flags=FLAGS — 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
• -A, --across — processes each input as a whole rather than line by line. This allows patterns to match across line boundaries but uses more memory and prevents streaming. iconic but not free, bestie. 💀
• -h, --help — print help (see a summary with -h). yes, that's what it says. iykyk. 👑
• -V, --version — print version.
• <FIND> — the regexp or string (if using -F) to search for. 🎯
• <REPLACE_WITH> — what to replace each match with. Unless in string mode, you may use captured values like $1, $2, etc. captured-value slay. ✨
• [FILES] — 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.

💀 EXIT STATUS 💀

• 0 — successful program execution. slay. ✅
• 1 — unsuccessful program execution. not the vibe. 😭
• 101 — the program panicked. literally screaming. 💀

🍓 EXAMPLES 🍓

String-literal mode

the -F girlies know: literal strings only, no regex chaos.

$ echo 'lots((([]))) of special chars' | sd -F '((([])))' ''
lots of special chars

Regex use. Let's trim some trailing whitespace

look at that trailing whitespace getting evicted. bye bestie. 👋

$ echo 'lorem ipsum 23   ' | sd '\s+$' ''
lorem ipsum 23

Indexed capture groups

capture groups are eating, no cap.

$ echo 'cargo +nightly watch' | sd '(\w+)\s+\+(\w+)\s+(\w+)' 'cmd: $1, channel: $2, subcmd: $3'
cmd: cargo, channel: nightly, subcmd: watch

Find & replace in file

in-place glow-up for http.js. 💖

$ sd 'window.fetch' 'fetch' http.js

Find & replace from STDIN an emit to STDOUT

yes, the original says “an emit” — we don't fix lore. 🫶

$ sd 'window.fetch' 'fetch' < http.js

---

okay that's the whole page, bestie — source/version: sd 1.0.0, manual: sd(1). The footer didn't give a date, so no fake timestamp energy here. mwah 💋🫶✨