RUBY(1)

RUBY(1) — the Sass one 💅

okay bestie, so this is the RUBY(1) page from the User Commands section, and yes it's filed under Ruby but it's literally all about Sass, don't @ me.

---

✨ NAME ✨

Ruby — Sass compiles CSS from SASS files 🎀

---

✨ SYNOPSIS ✨

sass [options] [INPUT] [OUTPUT]

---

✨ DESCRIPTION ✨

💖 Description:

Converts SCSS or Sass files to CSS. that's the whole vibe, no notes ✨

---

💖 Common Options:

• -I, --load-path PATH — tell Sass where to look for an import path 🫶
• -r, --require LIB — require a Ruby library before running Sass, like a little pre-game ritual 💅
• --compass — makes Compass imports available and loads the project configuration. iconic behavior 👑
• -t, --style NAME — the output style, bestie. it can be nested (the default, iykyk), compact, compressed, or expanded 🌸
• -?, -h, --help — shows this help message. so meta 💀
• -v, --version — prints the Sass version, for when you gotta know 👀

---

💖 Watching and Updating:

• --watch — watches files or directories for changes. the location of the generated CSS can be set using a colon 🦋

sass --watch input.sass:output.css
sass --watch input-dir:output-dir

• --poll — check for file changes manually, rather than relying on the OS. only meaningful for --watch fr fr
• --update — compile files or directories to CSS. locations are set exactly like --watch ✨
• -f, --force — recompile every Sass file, even if the CSS file is newer. only meaningful for --update, so don't get any ideas 😭
• --stop-on-error — if a file fails to compile, exit immediately. only meaningful for --watch and --update 💀

---

💖 Input and Output:

• --scss — use the CSS-superset SCSS syntax. superset means it's got range 💜
• --sourcemap=TYPE — how to link generated output to the source files. the tea:
  • auto (default): relative paths where possible, file URIs elsewhere
  • file: always absolute file URIs
  • inline: include the source text in the sourcemap
  • none: no sourcemaps
• -s, --stdin — read input from standard input instead of an input file. this is the default if no input file is specified 🎀
• -E, --default-encoding ENCODING — specify the default encoding for input files 🌈
• --unix-newlines — use Unix-style newlines in written files. always true on Unix, so like... congrats Unix users 🫶
• -g, --debug-info — emit output that can be used by the FireSass Firebug plugin. throwback energy 🔥
• -l, --line-numbers — emit comments in the generated CSS indicating the corresponding source line, extremely helpful bestie ⭐
• --line-comments — (no description given, she's mysterious like that 🙈)

---

💖 Miscellaneous:

• -i, --interactive — run an interactive SassScript shell. main character energy 💅
• -c, --check — just check syntax, don't evaluate. low stakes, high value ✨
• --precision NUMBER_OF_DIGITS — how many digits of precision to use when outputting decimal numbers. defaults to 10 🔢
• --cache-location PATH — the path to save parsed Sass files. defaults to .sass-cache 📁
• -C, --no-cache — don't cache parsed Sass files. no hoarding, we love a clean slate 🌸
• --trace — show a full Ruby stack trace on error. buckle up 🎢
• -q, --quiet — silence warnings and status messages during compilation. peace and quiet, obsessed 😌

---

heads up bestie: a couple of these only do anything in specific modes — --poll only matters for --watch, -f/--force only matters for --update, and --stop-on-error only matters for --watch and --update. don't come for me, it's in the docs 💖

---

and that's the whole page!! this was Ruby Sass 3.7.4, dated November 2021, and it's the RUBY(1) page from User Commands, slay 💅✨ bye bestie 🫶