richunits 0.2.0 → 0.5.0

data/CHANGES

@@ -1,4 +1,20 @@
+=== 0.5.0 / 2009-05-30
+
+* Name of gem and main require will be 'richunits' (no underscore).
+
+=== 0.4.0 / 2008-09-09
+
+* Rewrote Duration class and integrated into rest of system.
+
+=== 0.3.0 / 2008-09-08
+
+* Encapsulated entire library in RichUnits module.
+
+=== 0.2.0 / 2008-08-01
+
+* Reorganized repository.
+
 === 0.1.0 / 2008-03-27
 
-* Initial version, spun-off from Facets.
+* Initial version.
 

data/COPYING

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) <year> <copyright holders>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+

data/MANIFEST

@@ -1,24 +1,40 @@
 doc
+lib
+meta
 test
-test/test_bytes.rb
-test/test_multipliers.rb
-test/test_times.rb
 CHANGES
+RELEASE
+TODO
 README
-meta
+VERSION
+COPYING
+doc/ads
+doc/index.css
+doc/index.html
+doc/images
+doc/ads/rdoc.html
+doc/images/ruby.png
+doc/images/ruby-md.png
+doc/images/tiger_logo.png
+doc/images/ruby-sm.png
+doc/images/tiger-sm.png
+lib/rich_units.rb
+lib/richunits
+lib/richunits.rb
+lib/richunits/times.rb
+lib/richunits/duration.rb
+lib/richunits/multipliers.rb
+lib/richunits/weekdays.rb
+lib/richunits/bytes.rb
 meta/created
 meta/repository
 meta/homepage
 meta/abstract
 meta/title
+meta/version
 meta/license
 meta/contact
-lib
-lib/rich_units.rb
-lib/rich_units
-lib/rich_units/times.rb
-lib/rich_units/multipliers.rb
-lib/rich_units/weekdays.rb
-lib/rich_units/bytes.rb
-VERSION
-NEWS
+test/test_duration.rb
+test/test_bytes.rb
+test/test_multipliers.rb
+test/test_times.rb

data/README

@@ -1,5 +1,54 @@
 = Rich Units
 
-Rich Kilmer's Units System
+Easy Units for Ruby
 
+  http://richunits.rubyforge.org
+
+== Usage
+
+You only need to require 'rich_units' and all of RichUnit's
+extensions are loaded.
+
+  require 'richunits'
+
+  2.hours  #=> 7200
+
+RichUnits also includes a Duration class (inspired by Matthew Harris' version)
+for storing time measures. These measure were originally stored as Integer
+seconds. The Duration class instead stores the seconds as an attribute and
+adds a  an optional segements property which can be used to select exactly
+how to segment up the time period (years, week, days, etc.).
+
+See RDocs for complete API documentation.
+
+== Development
+
+GitHub Repository.
+
+  git://github.com/trans/richunits.git
+
+This project uses the Reap build system.
+
+  http://reap.rubyforge.org
+
+== TODO
+
+* Should we rename the Rubyforge project from richunits to rich_units?
+
+== Copying
+
+Copyright (c) 2008 TigerOps
+Copyright (c) 2006 Matthew Harris
+Copyright (c) 2004 Rich Kilmer
+
+If you have contributed to this code and feel you deserve mention
+in the copyright notice, please let us know. Since this code has
+been through a number of hands and other projects (Facets and
+ActiveSupport among them) it is hard to identify exactly who is
+responsible for what. Nonetheless, Rich Kilmer is the father of
+this code so most of the rights must fall to him.
+
+RichUnits is distributed under the terms of the MIT license.
+
+See COPYING file.
 

data/RELEASE

@@ -0,0 +1,21 @@
+This release updates some extensions to Time for use with the
+Duration class, and standardizes the library on the name 'richunits',
+rather than using the underscored "rich_units". This means installation
+is now:
+
+  gem install richunits
+
+and loading the library is now:
+
+  require 'richunits'
+
+Though a backward compatible require is still present.
+
+The previous release contains a complete rewrite of the Duration
+class and integrates it into the rest of the system.
+
+
+### 0.5.0 / 2009-05-30
+
+* Rewrote Duration class and integrated into rest of system.
+

data/TODO

@@ -0,0 +1,5 @@
+
+* Achieve 99.9% drop-in compatability with ActiveSupport.
+
+* Better TimeZone support.
+

data/VERSION

@@ -1 +1 @@
-richunits 0.2.0 beta (2008-09-06)
+richunits 0.5.0 beta (2009-05-30)

data/doc/ads/rdoc.html

@@ -0,0 +1,12 @@
+<div style="position: absolute; top: 5px; right: 10px;">
+  <script type="text/javascript"><!--
+  google_ad_client = "pub-1126154564663472";
+  //BLOW 234x60
+  google_ad_slot = "6480217558";
+  google_ad_width = 234;
+  google_ad_height = 60;
+  //--></script>
+  <script type="text/javascript"
+  src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
+  </script>
+</div>

data/doc/index.css

@@ -0,0 +1,179 @@
+* {
+  padding     : 0;
+  margin      : 0;
+  font-family : sans-serif;
+}
+
+body {
+  color       : black;
+  background  : white;
+  text-align  : center;
+  position    : relative;
+  font-size   : 10px;
+}
+
+p {
+  text-align  : justify;
+  font-size   : 12px;
+  color       : #555;
+  font-weight : normal;
+  margin      : 10px 0px 10px 0px;
+  line-height : 1.5em;
+  letter-spacing: 1px;
+}
+
+/*
+p.intro {
+  font-size: 14px;
+  font-weight: normal;
+  letter-spacing: 1px;
+}
+*/
+
+a {
+  color: #EF0040;
+}
+
+img {
+  border: none;
+}
+
+pre {
+  font-family  : monospace;
+  font-size    : 8pt;
+  color        : #eeeeee;
+  background   : #1f0f0f;
+  margin       : 10px;
+  font-weight  : bold;
+  line-height  : 1.5em;
+  padding-top  : 15px;
+  text-align   : left;
+}
+
+h1 {
+  font-size: 60px;
+}
+
+h2 {
+  font-size: 40px;
+  text-align: left;
+  margin-top: 50px;
+}
+
+h3 {
+  text-align: left;
+  margin-top: 20px;
+}
+
+td {
+  vertical-align: top;
+}
+
+.container {
+  width        : 730px;
+  margin       : 0 auto;
+  position     : relative;
+}
+
+
+.aside {
+  float: left;
+  width: 164px;
+  padding: 20px;
+  margin: 40px;
+  text-align: center;
+  background: black;
+  border: 0px solid gray;
+  margin-top: 40px;
+}
+
+.aside a {
+  color: #EF0040;
+  font-weight: bold;
+}
+
+.aside p {
+  text-align: center;
+}
+
+.header {
+  padding: 70px 40px 50px 60px;
+  background: url(images/ruby-md.png) 500px 30px no-repeat #111111;
+  text-align: left;
+  font-weight: bold;
+  margin-bottom: 20px;
+  border: 1px solid gray;
+}
+
+.title {
+  color: white; font-size: 62px;
+}
+
+.subtitle {
+  color: white;
+  font-size: 16px;
+}
+
+.content {
+  padding: 0 0;
+}
+
+.about {
+  margin: 0 0 20px 0;
+  padding: 20px;
+  text-align: justify;
+  font-size: 20pt;
+  font-weight: bold;
+  background: #BF0020;
+  color: white;
+  border: 1px solid pink;
+}
+
+.menu {
+  width          : 730px;
+  margin         : 0 auto;
+  padding        : 15px 30px;
+  color          : orange;
+  font-size      : 12px;
+  text-align     : left;
+}
+
+.menu a {
+  font-size: 1em;
+  font-weight: bold;
+  color: red;
+  text-decoration: none;
+}
+
+.menu a:hover {
+  text-decoration: underline;
+}
+
+.ad {
+  border      : 0px solid white;
+  text-align  : center;
+}
+
+.invert {
+  text-align   : left;
+  color        : white;
+  margin       : 0;
+  padding      : 15px 15px 15px 15px;
+  background   : black;
+}
+
+.invert p {
+  text-align   : left;
+  color        : white;
+}
+
+.copyright {
+  padding     : 5px;
+  text-align  : center;
+  color       : gray;
+  font-size   : 1.2em;
+  border      : 1px solid gray;
+  background  : #111111;
+  margin      : 20px 1px;
+}
+

data/doc/index.html

@@ -0,0 +1,163 @@
+
+<html>
+
+<head>
+  <title>Rich Units</title>
+
+  <link href="index.css" rel="stylesheet" type="text/css"/>
+  <link href="images/ruby-sm.png" rel="icon"/>
+
+  <META NAME="DESCRIPTION" CONTENT="Rich Units system for the Ruby programming lanaguage.">
+  <META NAME="KEYWORDS" CONTENT="units, ruby, numeric, time">
+</head>
+
+<body>
+
+<div class="menu">
+  <div style="float: right; font-weight: bold;">A <a href="http://tigerops.org">TigerOps</a> PROJECT</div>
+  <!-- &lt;<a href="http://tigerops.rubyforge.org/">Homepage</a>&gt; -->
+  <a href="rdoc/index.html">Documentation</a> &middot;
+  <a href="http://rubyforge.org/frs/?group_id=7034">Download</a> &middot;
+  <a href="http://rubyforge.org/projects/richunits">Development</a>
+</div>
+
+<div class="container">
+
+  <div class="header">
+    <span class="title">Rich Units</span>
+  </div>
+
+  <div class="content">
+
+    <p class="about">
+      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.
+    </p>
+
+    <h2>Introduction</h2>
+
+    <p class="intro">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.
+    </p>
+
+    <p class="intro">Rich Units provides essentially the same unit system used by
+       <a href="http://www.rubyonrails.org/">Ruby on Rails</a>*. But Rich Units seeks to imporve
+       upon this code, and provides a superset of functionality, partly derived from the
+       <a href="facets.rubyforge.org">Ruby Facets</a> 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.
+    </p>
+
+    <p><span style="font-size:0.8em;"> *with the present exception of the timezone extensions (coming soon).</span></p>
+
+    <h2>Examples</h2>
+
+    <p>
+      Primarily Rich Units extends Numeric.
+      Here are some basic examples:
+    </p>
+
+    <pre>
+      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
+    </pre>
+
+    <p>Rich Units also extends Time.</p>
+
+    <pre>
+      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
+    </pre>
+
+
+    <h2>Installation</h2>
+
+    <p>
+      Installing the RubyGem is of course straight forward.
+    </p>
+
+    <pre>
+      $ sudo gem install rich_units
+    </pre>
+
+    <p>
+      Manual site_ruby installation is provided via <a href="http://setup.rubyforge.org">Ruby Setup</a>.
+    </p>
+
+    <pre>
+      $ tar -xvzf rich_units-0.4.0.tgz
+      $ cd rich_units-0.4.0
+      $ sudo setup.rb all
+    </pre>
+
+
+    <h2>Development</h2>
+
+    <p>You can use gitweb to browse the 'richunits' repository.</p>
+
+    <h3>Anonymous Repository Access</h3>
+
+    <p>To pull the 'richunits' repository anonymously, use:</p>
+
+    <pre>
+      git clone git://rubyforge.org/richunits.git
+    </pre>
+
+    <h3>Master Developer Repository Access</h3>
+
+    <p>Developers: You can push to the 'richunits' repository using:</p>
+
+    <pre>
+      gitosis@rubyforge.org:richunits.git
+    </pre>  
+
+    <p>Only project developers have access to this repository.
+       Please contact <b>transfire at gmail.com</b> if you'd like to join the development team.
+    </p>
+
+    <h3>Contributor Repository Access</h3>
+
+    <p>This project is also hosted on GitHub at</p>
+
+    <pre>
+      http://github.com/trans/richunits/tree/master
+    </pre>  
+  </div>
+
+  <br/><br/>
+
+  <div style="text-align: center; padding: 20px 0; border-top: 1px solid #ccc;">
+    <script type="text/javascript"><!--
+    google_ad_client = "pub-1126154564663472";
+    /* TIGER 728x90 10/28/08 */
+    google_ad_slot = "2386645975";
+    google_ad_width = 728;
+    google_ad_height = 90;
+    //-->
+    </script>
+    <script type="text/javascript"
+    src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
+    </script>
+    <!-- <iframe src="http://tigerops.org/assets/adverts/banner-900-1.html" scrolling="no"></frame> -->
+  </div>
+
+  <div class="copyright">
+    <br/><br/>
+    <span style="color: #EF0040;">Rich Units</span> Copyright (c) 2007, 2008 <a href="http://tigerops.org">Tiger Ops</a>
+    <br/><br/>
+    Rich Units is distributed under the terms of the MIT license. <br/>
+    <br/><br/>
+  </div>
+
+</div>
+
+</body>
+</html>