versionize 1.0.0

data/LICENSE

@@ -0,0 +1,23 @@
+# Open Works License
+
+This is version 0.9.2 of the Open Works License.
+
+## Terms
+
+Permission is hereby granted by the copyright holder(s), author(s), and
+contributor(s) of this work, to any person who obtains a copy of this work in
+any form, to reproduce, modify, distribute, publish, sell, use, or otherwise
+deal in the licensed material without restriction, provided the following
+conditions are met:
+
+Redistributions, modified or unmodified, in whole or in part, must retain
+applicable copyright notices, the above license notice, these conditions, and
+the following disclaimer.
+
+NO WARRANTY OF ANY KIND IS IMPLIED BY, OR SHOULD BE INFERRED FROM, THIS LICENSE
+OR THE ACT OF DISTRIBUTION UNDER THE TERMS OF THIS LICENSE, 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
+WORK, OR THE USE OF OR OTHER DEALINGS IN THE WORK.

data/README.md

@@ -0,0 +1,54 @@
+# Versionize
+
+I wanted simple version capabilities.  Here they are.
+
+
+## usage
+
+Using Versionize is dead simple right now.  First require and include it, then
+define your version hash, and finally use the methods Versionize provides:
+
+        #!/usr/bin/env ruby
+        require 'versionize'
+        
+        class Foo
+          include Versionize
+          @version = {
+            :major      => 1,
+            :minor      => 0,
+            :revision   => 2
+          }
+        end
+
+        Foo.version
+        Foo.version(:array)
+        Foo.version(:hash)
+        Foo.major
+        Foo.major(:string)
+        Foo.minor
+        Foo.minor(:string)
+        Foo.revision
+        Foo.revision(:string)
+
+The return values from this example are:
+
+        => "1.0.2"
+        => [1, 0, 2]
+        => {:major=>1, :minor=>0, :revision=>2}
+        => 1
+        => "1"
+        => 0
+        => "0"
+        => 2
+        => "2"
+
+That's about all there is to it.
+
+
+## credits
+
+This program was written by Chad Perrin, Copyright 2012.  It can be
+redistributed under the terms of the Open Works License (see LICENSE file).
+More information about the OWL can be found at:
+
+    http://owl.apotheon.org

data/lib/versionize.rb

@@ -0,0 +1,118 @@
+=begin rdoc
+
+Versionize provides a simple version management and reporting interface for
+Ruby projects.  Include the Versionize module in your class, set the @version
+variable, and start using the version method.  Away you go.
+
+=end
+
+module Versionize
+  def self.included(base)
+    base.extend(ClassMethods)
+  end
+
+=begin
+
+The +@version" hash is the core of Versionize.  Set the values of the three
+sub-versions (+:major+, +:minor+, and +:revision+) to desired values.
+
+=end
+
+  @version = {
+    :major      =>  1,
+    :minor      =>  0,
+    :revision   =>  0
+  }
+
+  module ClassMethods
+
+=begin
+
+The +version+ method takes one optional argument +format+, indicating the type
+of data you want the method to return (+:array+, +:hash+, or +:string+).  The
+default format is +:string+.  The return value includes all three sub-versions.
+
+Examples:
+
+        Versionize.version
+        => "0.0.1"
+
+        Versionize.version(:array)
+        => [0,0,1]
+
+        Versionize.version(:hash)
+        => {:major=>0,:minor=>0,:revision=>1}
+
+=end
+
+    def version(format=:string)
+      case format
+      when :array
+        [ @version[:major], @version[:minor], @version[:revision] ]
+      when :hash
+        @version
+      when :string
+        version(:array).collect {|n| n.to_s }.join '.'
+      end
+    end
+
+=begin
+
+The +major+ method takes one optional argument +format+, indicating the type of
+data you want the method to return (+:integer+ or +:string+).  The default
+format is +:integer+.  The return value includes only the +:major+ sub-version.
+
+Examples:
+
+        Versionize.major
+        => 0
+
+        Versionize.major(:string)
+        => "0"
+
+=end
+
+    def major(format=:integer)
+      case format
+      when :integer
+        @version[:major]
+      when :string
+        @version[:major].to_s
+      end
+    end
+
+=begin
+
+The +minor+ method operates just like the +major+ method except that its return
+value includes only the +:minor+ sub-version.
+
+=end
+
+    def minor(format=:integer)
+      case format
+      when :integer
+        @version[:minor]
+      when :string
+        @version[:minor].to_s
+      end
+    end
+
+=begin
+
+The +revision+ method operates just like the +major+ method except that its
+return value includes only the +:revision+ sub-version.
+
+=end
+
+    def revision(format=:integer)
+      case format
+      when :integer
+        @version[:revision]
+      when :string
+        @version[:revision].to_s
+      end
+    end
+  end
+
+  extend ClassMethods
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: versionize
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Chad Perrin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-23 00:00:00.000000000 Z
+dependencies: []
+description: ! '    Versionize exists to provide simple version management and reporting.
+
+'
+email: code@apotheon.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/versionize.rb
+homepage: http://versionize.fossrec.com
+licenses:
+- OWL
+post_install_message: ! '    Thank you for using Versionize.  See the rdoc for details.
+
+'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Versionize - simple software versions
+test_files: []