RichUnits is a very easy to use unit system for the Ruby programming language. It is essentially the same system popularized by Ruby on Rails.

Introduction

Rich Units is a straight-forward units system based-on the original time units work by Rich Kilmer (circa 2002-2004). Rich Units extends core Ruby with conveneice methods for dealing with measures. The methods work by converting those measures to a low common denominator; for instance all durations are stored in seconds.

Rich Units provides essentially the same unit system used by Ruby on Rails*. But Rich Units seeks to imporve upon this code, and provides a superset of functionality, partly derived from the Ruby Facets distribution of the same libraries. Ultimately Rich Units intent is to provide a better system than either of these large projects can provide, by virture of a dedicated development track.

*with the present exception of the timezone extensions (coming soon).

Examples

Primarily Rich Units extends Numeric. Here are some basic examples:

      require 'rich_units'

      4.days.hence    #=> Tue Apr 01 08:04:17 -0400 2008
      4.hours.ago     #=> Thu Mar 27 22:03:33 -0400 2008

      10.bytes        #=> 80
    

Rich Units also extends Time.

      require 'rich_units'

      Time.now                   #=> Fri Mar 28 08:10:40 -0400 2008
      Time.now.years_hence(4)    #=> Wed Mar 28 08:10:47 -0400 2012
    

Installation

Installing the RubyGem is of course straight forward.

      $ sudo gem install rich_units
    

Manual site_ruby installation is provided via Ruby Setup.

      $ tar -xvzf rich_units-0.4.0.tgz
      $ cd rich_units-0.4.0
      $ sudo setup.rb all
    

Development

You can use gitweb to browse the 'richunits' repository.

Anonymous Repository Access

To pull the 'richunits' repository anonymously, use:

      git clone git://rubyforge.org/richunits.git
    

Master Developer Repository Access

Developers: You can push to the 'richunits' repository using:

      gitosis@rubyforge.org:richunits.git
    

Only project developers have access to this repository. Please contact transfire at gmail.com if you'd like to join the development team.

Contributor Repository Access

This project is also hosted on GitHub at

      http://github.com/trans/richunits/tree/master