Created: 2008-11-12 21:20
Updated: 2016-05-08 16:47


yarg: Yet Another Ruby Generator

Yarg is Yet Another Ruby Generator. It allows you to customize existing project generators to fit your personality or common scaffolding. In other words, it allows you to bootstrap new projects without the typical mundane setup.

While I still have a fondness for the approach taken here, I've abandoned this project (for now). My original need for this project was mostly fulfilled when Rails Templates were introduced in Rails 2.3. When you can't beat 'em, join 'em.

Yarg is still in its infancy. It currently works for rails generation, but use it at your own risk.



$ sudo gem install rmm5t-yarg --source http://gems.github.com

Configure by placing a ~/.yarg file in your home directory. Here's a simple example

Yarg::Rails.new do |rg|
  rg.scm :git
  rg.delete "public/index.html"
  rg.plugin "git://github.com/thoughtbot/shoulda.git"

Here's another example:

Yarg::Rails.new do |rg|
  rg.scm :git, :using => :submodules
  rg.template "~/.yarg.d/rails"
  rg.delete "public/index.html"
  rg.delete "public/dispatch.*"
  rg.plugin "git://github.com/thoughtbot/shoulda.git"
  rg.plugin "git://github.com/nex3/haml.git"
  rg.plugin "git://github.com/rmm5t/strip_attributes.git"
  rg.plugin "git://github.com/github/hubahuba.git"
  rg.freeze :version => :edge

Afterwards, you should be able to launch a new Rails project easily:

$ yarg my_new_project


  • Add better option parsing support in script (including a template name option)
  • Add better handling of error conditions
  • Add rails gem freezing support
  • Add newgem support
  • Add merb support
  • Add webby support
  • Add staticmatic support
  • Add svn support (?)


MIT License

Copyright (c) 2008, Ryan McGeary (ryanonruby -[at]- mcgeary [dot] org)

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more