One day you will be able to write a human description of a RubyGem and it will make it for you. Ok, that’s crap. But the New Gem Generator is doing more and more cooler things lately; so let’s take a peek…
$ newgem my_cool_gem -t rspec $ cd my_cool_gem $ rake # runs specs
New gems now have a
website folder with an
index.txt file (redcloth format). Put your glorious promotional materials and tutorials here (plus add additional .txt files as well) and the
rake website task will convert them to html files and upload them to your rubyforge website.
The standard template looks like this (you’re encouraged to change some colours or fonts!)
Ready to release a new X.Y.Z version of your gem? It takes 3 minutes.
- Set the version number in
- Check your Manifest.txt that it includes all new files (via
History.txtwith changes. The default supported format is 2 paragraphs – a header and group of bullet points; these look nice when converted to rdoc format.
- Commit the new version to repository.
- Deploy/release gem
$ rake deploy VERSION=X.Y.Z
This will release your RubyGem to rubyforge so people can install it; plus upload your website and your rdocs.
You’ll then be prompted to commit a copy of the trunk as a tag
REL-X.Y.Z. This could be very useful one day!
Video of NewGem at RejectConf
You can read the pdf slides and/or watch the presentation from RejectConf:
- Hacking someone’s gem with github and gemcutter Ever used a rubygem, found a bug, and just...
- Future proofing your Ruby code. Ruby 1.9.1 is coming. Bugger. I’m a Ruby monogamist. I use the Ruby...
- newgem 1.0.0 all thanks to Cucumber The New Gem Generator (newgem) was exciting, moderately revolutionary, and...
- RubiGen video from RejectConf Berlin Go straight to video below I took a video recorder...
- RejectConf tonight – RailsConfEurope 2007 Tonight only. Live in Berlin. One show only. RejectConf. Woohoo!...