better

= Overview

Better is a collection of better replacements Ruby standard libraries. The versions shipped with Ruby have problems, which this library intends to fix. It is my wish that this code will one day find its way back to upstream Ruby.

• Github: http://github.com/FooBarWidget/better/tree/master
• API documentation: http://better.rubyforge.org/

== Usage

Install with:

gem install better

All of the libraries in Better are drop-in replacement and have the exact same API as the original, and work on both Ruby 1.8 and 1.9. For example, instead of

require 'tempfile' Tempfile.new(...)

you just prefix the library filename with 'better/' and the class name with 'Better::':

require 'better/tempfile' Better::Tempfile.new(...)

Or you can even override the standard version by requiring the library with the 'better/override/' prefix:

require 'better/override/tempfile' Tempfile # => now refers to Better::Tempfile instead of ::Tempfile

This last feature should of course be used with care.

Please refer to the individual classes for more documentation.

== Contributing

The Github repository is located at http://github.com/FooBarWidget/better/tree/master. Is there a Ruby standard library that you think can be improved? Just fork the repository and start hacking! It doesn't matter whether you want to fix a small bug, want to write unit tests or just want to improve documentation - anything is fine.

You can contact me at:

• Hongli Lai ([e-mail])