CLANG-FORMAT-DIFF.PY(1)

💖 CLANG-FORMAT-DIFF.PY 💖

okay bestie, so we're looking at clang-format-diff.py — that's the manual page for clang-format-diff.py version 13, living in the User Commands corner of the manual. pull up a chair 🎀

---

🌸 NAME 🌸

clang-format-diff.py — the manual page for clang-format-diff.py 13. that's it, that's the name, no notes 💅

---

✨ DESCRIPTION ✨

so the usage line goes like this, no cap:

usage: clang-format-diff.py [-h] [-i] [-p NUM] [-regex PATTERN]
[-iregex PATTERN] [-sort-includes] [-v]
       [-style STYLE] [-binary BINARY]

here's the tea 🍓: this script reads input from a unified diff and reformats all the changed lines. it's lowkey perfect for when you want to reformat literally every line a specific patch touched. main character behaviour, honestly.

example usage for all my git/svn girlies:

git diff -U0 --no-color --relative HEAD^ | clang-format-diff.py
-p1 -i svn diff --diff-cmd=diff -x-U0 | clang-format-diff.py -i

⚠️ okay important heads-up: the filename inside the diff is used unmodified to figure out which source file to update. so if you're calling this script directly, be careful fr fr — make sure the path in the diff is actually correct relative to your current working directory. don't be sloppy, it's giving consequences 😭

🧚 options:

• -h, --help — shows this help message and then dips. exit stage left. 👋
• -i — actually applies the edits to your files instead of just showing you a diff. it's the "do it, don't just talk about it" flag.
• -p NUM — strips the smallest prefix that contains P slashes. bye bye path prefix 🦋
• -regex PATTERN — your own custom pattern for picking which file paths get reformatted. it's case sensitive, and it overrides -iregex. 👑
• -iregex PATTERN — same deal, custom pattern for picking file paths to reformat, but this one is case insensitive. and heads up: it gets overridden by -regex. so -regex is the one holding the crown here 💜
• -sort-includes — lets clang-format sort the include blocks. let it cook 🍳
• -v, --verbose — be more verbose. lowkey useless without -i tho, just so you know 💀
• -style STYLE — the formatting style to apply. your options are LLVM, GNU, Google, Chromium, Microsoft, Mozilla, WebKit. pick your fighter ✨
• -binary BINARY — the location of the binary to use for clang-format. point it at your fave 🫶

---

and that's the whole page bestie, you ate that 💖

this was clang-format-diff.py version 13, and the page is dated July 2023 — consider this your little sign-off from the manpage girlies 🌸✨ slay, go reformat something, periodt 💅