public
Description: Opinionated tool for creating and managing Rubygem projects
Home | Edit | New

Starting a new project

Jeweler provides a generator. It requires you to setup your name and email for git and your username and token for GitHub.

This is the most basic usage:

jeweler the-perfect-gem

This will prepare a project in the ‘the-perfect-gem’ directory, setup to use Jeweler.

It also supports a number of options:

  • --create-repo in addition to preparing a project, it create an repo up on GitHub and enable RubyGem generation
  • --testunit generate test_helper.rb and test ready for test/unit
  • --minitest generate test_helper.rb and test ready for minitest
  • --shoulda generate test_helper.rb and test ready for shoulda (this is the default)
  • --rspec generate spec_helper.rb and spec ready for rspec
  • --bacon generate spec_helper.rb and spec ready for bacon
  • --rubyforge setup releasing to rubyforge

Jeweler respects the JEWELER_OPTS environment variable. Want to always use RSpec, and you’re using bash? Add this to ~/.bashrc:

export JEWELER_OPTS="--rspec"
Last edited by slothbear, Sat Jul 18 16:32:00 -0700 2009
Home | Edit | New
Versions: