RAKE(1)

โœจ RAKE(1) โ€” NAME โœจ

rake ๐Ÿ’– is a make-like build utility for Ruby, and bestie, it is literally so good. The manual name is rake(1), which I am obsessed with.

Quick note before we start: the em-dash and the header stuff are just the page's little intro, so I'm keeping the vibe but not the formatting.

๐ŸŽ€ SYNOPSIS ๐ŸŽ€

rake [-f rakefile] [options] targets ...

๐ŸŒธ DESCRIPTION ๐ŸŒธ

okay so rake is a make(1)-like build utility for Ruby ๐Ÿ”ฅ. Tasks and dependencies get written in standard Ruby syntax, so if you already speak Ruby you're basically fluent already ๐Ÿ’….

๐Ÿ’… OPTIONS ๐Ÿ’…

  • -m, --multitask โ€” treat all tasks as multitasks โœจ
  • -B, --build-all โ€” build all prerequisites, even the ones that are already up-to-date ๐Ÿซถ
  • -j, --jobs num_jobs โ€” sets the max number of tasks that can run in parallel (default is number of CPU cores + 4) ๐Ÿ”ฅ

๐Ÿงš Modules ๐Ÿงš

  • -I, --libdir libdir โ€” adds libdir to the search path for required modules ๐Ÿฆ‹
  • -r, --require module โ€” requires module before running the rakefile ๐Ÿ’œ

๐Ÿ—บ๏ธ Rakefile location ๐Ÿ—บ๏ธ

  • -f, --rakefile filename โ€” uses filename as the rakefile to look for ๐Ÿ“
  • -N, --no-search, --nosearch โ€” don't search parent directories for the Rakefile ๐Ÿ™ˆ
  • -G, --no-system, --nosystem โ€” use the standard project Rakefile search paths and ignore system-wide rakefiles ๐ŸŒˆ
  • -R, --rakelib rakelibdir, --rakelibdir rakelibdir โ€” auto-imports any .rake files in rakelibdir (default is โ€˜rakelibโ€™) ๐ŸŽ€
  • -g, --system โ€” uses system-wide (global) rakefiles (usually ~/.rake/*.rake) โœจ

๐Ÿ› Debugging ๐Ÿ›

  • --backtrace=out โ€” enables the full backtrace. out can be stderr (default) or stdout ๐Ÿ’€
  • -t, --trace=out โ€” turns on invoke/execute tracing and enables full backtrace. out can be stderr (default) or stdout ๐Ÿ‘‘
  • --suppress-backtrace pattern โ€” suppresses backtrace lines matching the regexp pattern. Ignored if --trace is on ๐Ÿ™ˆ
  • --rules โ€” traces the rules resolution ๐Ÿฆ‹
  • -n, --dry-run โ€” does a dry run without executing actions ๐Ÿซถ
  • -T, --tasks [pattern] โ€” displays the tasks (matching the optional pattern) with descriptions, then exits ๐Ÿ’–
  • -D, --describe [pattern] โ€” describes the tasks (matching the optional pattern), then exits ๐ŸŒธ
  • -W, --where [pattern] โ€” describes the tasks (matching the optional pattern), then exits ๐Ÿ’œ
  • -P, --prereqs โ€” displays the tasks and dependencies, then exits ๐Ÿงš
  • -e, --execute code โ€” executes some Ruby code and exits โœจ
  • -p, --execute-print code โ€” executes some Ruby code, prints the result, then exits ๐Ÿ“
  • -E, --execute-continue code โ€” executes some Ruby code, then continues with normal task processing ๐Ÿ”ฅ

๐Ÿ“ฃ Information ๐Ÿ“ฃ

  • -v, --verbose โ€” logs messages to standard output ๐ŸŒˆ
  • -q, --quiet โ€” doesn't log messages to standard output ๐Ÿ™ˆ
  • -s, --silent โ€” like --quiet, but also suppresses the โ€˜in directoryโ€™ announcement ๐Ÿคซ
  • -X, --no-deprecation-warnings โ€” disables the deprecation warnings ๐Ÿ’€
  • --comments โ€” shows commented tasks only ๐ŸŽ€
  • -A, --all โ€” shows all tasks, even uncommented ones (in combination with -T or -D) โœจ
  • --job-stats [level] โ€” displays job statistics. If level is โ€˜historyโ€™, it displays a complete job list ๐Ÿฆ‹
  • -V, --version โ€” displays the program version ๐Ÿ‘‘
  • -h, -H, --help โ€” displays a help message ๐Ÿ’œ

๐Ÿฆ‹ SEE ALSO ๐Ÿฆ‹

okay the complete documentation for rake has been installed at /usr/share/doc/rake-doc/html/index.html, and it's also available online at https://ruby.github.io/rake ๐ŸŒธ

๐Ÿ‘‘ AUTHORS ๐Ÿ‘‘

rake was written by Jim Weirich <jim@weirichhouse.org> ๐Ÿ’–

This manual was created by Caitlin Matos <caitlin.matos@zoho.com> for the Debian project (but may be used by others). It was inspired by the manual by Jani Monoses <jani@iv.ro> for the Ubuntu project ๐Ÿซถ


bestie, that's the whole thing: rake 11.2.2, June 12, 2016, RAKE(1) ๐Ÿ’…โœจ periodt ๐ŸŒˆ