new-age 0.0.10

data/.gitignore

@@ -0,0 +1,9 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.DS_Store
+vendor/ruby/
+bin/
+.yardoc/
+docs/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format nested

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in NewAge.gemspec
+gemspec

data/NewAge.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "NewAge/version"
+
+Gem::Specification.new do |s|
+  s.name        = "new-age"
+  s.version     = NewAge::VERSION
+  s.authors     = ["Iain Barnett"]
+  s.email       = ["iainspeed@gmail.com"]
+  s.homepage    = "https://github.com/yb66/NewAge"
+  s.summary     = %q{Handling the input and output of people's ages in years and months}
+  s.description = %q{Handling the input and output of people's ages in years and months}
+
+  s.rubyforge_project = "NewAge"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "yard"
+  s.add_development_dependency "reek"
+  s.add_development_dependency "redcarpet"
+end

data/README.markdown

@@ -0,0 +1,39 @@
+## Welcome to the New Age! ##
+
+Excuse me while I light some scented candles...
+
+Handling age as an input is pain. Should it be 12.5? 12 years? Two separate fields on a form, one for year, one for month?
+
+    puts NewAge "12y 5m"   #=> "12 years 5 months"
+
+    NewAge("28").age       #=> {years: 28, months: 0}
+    
+    puts NewAge "9 months" #=> "0 years 9 months"
+
+    NewAge("72 y 6m").to_s #=> "72 years 6 months"
+    NewAge("72 y 6m").to_s( "%d YEARS" ) #=> "72 YEARS"
+
+    puts NewAge "12.5"     #=> 12 years 5 months
+    # No, I don't think it should be 6 months.
+
+    puts NewAge "12.11"    #=> 12 years 11 months
+    puts NewAge "12 11"    #=> 12 years 11 months
+    puts NewAge "12-11"    #=> 12 years 11 months
+    puts NewAge "12"       #=> 12 years 0 months
+    puts NewAge "12 m"     #=> 0 years 12 months
+
+There's nothing but years and months as that is all I need for now. The validation is not very strict, just enough to let two numbers in that are recognised as a year and a month. 
+
+## Licence ##
+
+This is under the MIT Licence.
+
+Copyright (c) 2012 Iain Barnett
+
+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.
+
+In other words, be good.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/NewAge.rb

@@ -0,0 +1,102 @@
+# encoding: UTF-8
+
+require_relative "./NewAge/version.rb"
+
+# @see NewAge::Age#initialize
+def NewAge( opts=nil )
+  NewAge::Age.new opts
+end
+
+module NewAge
+
+  module Helpers
+  
+    # Pass in a string with either two numbers,
+    # or one number for just a year, or a number with an indicator such as "m" or "y", like so:
+    # "n years m months" or
+    # "n" for years only or
+    # "n m months" or
+    # "m months" or
+    # "n y m m" or
+    # "n yrs m mths" or something similar. It may accept things like "11 minutes" (it will think you mean 11 months) because it's not *that* concerned about being exact, so be careful.
+    # @example
+    #   parse( "15 y 6 m" ) => {years: 15, months: 6}
+    # @param [String] s
+    # @return [Hash]
+    def parse( s )
+      raise ArgumentError, "Must provide a string to parse!" if s.nil? || s.empty? 
+      age = {}
+      case s
+        when /^(\d+)$/ then 
+          age[:years] = $1.to_i
+        when /^(\d+)\D+(\d+)\D*/
+          age[:years] = $1.to_i
+          age[:months] = $2.to_i
+        when /^(\d+)\s*m\w*$/
+          age[:months] = $1.to_i
+        else
+          raise ArgumentError, %q!The string wasn't in a format NewAge recognises, try `n years m months`!
+      end
+      
+      age = {years: 0, months: 0}.merge age # to stop errors from nils
+      
+      raise ArgumentError, "There are only 12 months in a year." if age[:months] >= 12
+      
+      raise ArgumentError, "The longest confirmed human life span was Jeanne Calment's at 122 years, 164 days. I doubt you need more than that." if age[:years] >= 122 && age[:months] >= 7
+      
+      raise ArgumentError, "I wasn't born yesterday!" if age[:years].zero? && age[:months].zero?
+      
+      age
+    end
+  end
+  
+  # Transform inputs into atomicised numbers for a person's age.
+  class Age
+    extend Helpers
+    
+    DEFAULTS = {years: 0, months: 0}
+    
+    FORMAT = "%d years %d months"
+    
+    def format=( s )
+      @format = s
+    end
+    
+    def format
+      @format ||= FORMAT
+    end
+    
+    
+    def []( key )
+      @age[key]
+    end
+    
+    def []=( key, value )
+      @age[key] = value
+    end
+    
+    # @overload new( Hash )
+    #   @param [Hash] opts Options hash
+    #   @option opts [Integer] years
+    #   @option opts [Integer] months
+    # @overload new( String )
+    #   @param (see Helpers#parse)
+    # @example
+    #   age = NewAge::Age.new( years: 5, months: 11 )
+    #   age = NewAge::Age.new( "28" )
+    def initialize( opts=nil )
+      opts = Age.parse(opts) if opts.kind_of? String
+      opts ||= {}
+      @age = DEFAULTS.merge opts
+    end
+    
+    attr_accessor :age
+    
+
+    # @param [optional, String] format A sprintf format string.
+    def to_s( format=nil )
+      format ||= self.format
+      sprintf format, @age[:years], @age[:months]
+    end
+  end
+end

data/lib/NewAge/version.rb

@@ -0,0 +1,3 @@
+module NewAge
+  VERSION = "0.0.10"
+end

data/lib/new-age.rb

@@ -0,0 +1 @@
+require_relative "./NewAge.rb"

data/spec/new_age_spec.rb

@@ -0,0 +1,72 @@
+# encoding: UTF-8
+
+require_relative './rspec_helper.rb'
+
+describe "Age" do
+  describe :parse do
+    context "Given valid data" do
+      
+      NewAge::RSpec::Helpers.all_together.each do |input,(ymd,output)|
+        it "should return a hash with #{output} in it given #{input}" do
+          NewAge::Age.parse( input ) == {years: ymd.first, months: ymd[1]} 
+        end
+      end
+    end
+    context "Given invalid data" do
+      context "i.e. no data at all" do
+        context "no arguments" do
+          it "should probably throw a wobbly" do
+            expect { NewAge::Age.parse }.to raise_error(ArgumentError)
+          end
+        end
+        context "nil argument" do
+          it "should probably throw a wobbly" do
+            expect { NewAge::Age.parse nil }.to raise_error(ArgumentError)
+          end
+        end
+      end
+      context "i.e. bad data" do
+        context "Silly things" do
+          let(:bad_data) { "Hacky sack" }
+          it "should probably throw a wobbly" do
+            expect { NewAge::Age.parse bad_data }.to raise_error(ArgumentError)
+          end
+        end
+        context "Someone with no age" do
+          let(:bad_data) { "0y 0m" }
+          it "should probably throw a wobbly" do
+            expect { NewAge::Age.parse bad_data }.to raise_error(ArgumentError)
+          end
+        end
+        context "Someone far too old to be human" do
+          let(:bad_data) { "123y 7m" }
+          it "should probably throw a wobbly" do
+            expect { NewAge::Age.parse bad_data }.to raise_error(ArgumentError)
+          end
+        end
+        
+      end
+    end
+  end
+  describe "to_s" do
+    context "Given no format" do
+      NewAge::RSpec::Helpers.all_together.each do |input,(ymd,output)|
+        it "should return an output of #{output} given #{input}" do
+          age = NewAge::Age.new( input )
+          age.to_s.should == output
+        end
+      end
+    end
+    context "Given a format" do
+      context " of n yrs n mths" do      
+        NewAge::RSpec::Helpers.all_together.each do |input,(ymd,output)|
+          it "should return an output of #{ymd[0]} yrs #{ymd[1]} mnths given #{input}" do
+            age = NewAge::Age.new( input )
+            age.to_s( "%d yrs %d mnths" ).should == "#{ymd[0]} yrs #{ymd[1]} mnths"
+          end
+        end
+      end
+    end
+  end
+  
+end

data/spec/rspec_helper.rb

@@ -0,0 +1,25 @@
+# encoding: UTF-8
+
+require 'rspec'
+require_relative "../lib/NewAge.rb"
+
+
+Spec_dir = File.expand_path( File.dirname __FILE__ )
+
+
+require "logger"
+logger = Logger.new STDOUT
+logger.level = Logger::DEBUG
+logger.datetime_format = '%a %d-%m-%Y %H%M '
+LOgger = logger
+
+
+Dir[ File.join( Spec_dir, "/support/**/*.rb")].each do |f| 
+  logger.info "requiring #{f}"
+  require f
+end
+
+
+# RSpec.configure do |c|
+#   c.include NewAge::RSpec::Helpers
+# end

data/spec/support/shared/contexts.rb

@@ -0,0 +1,32 @@
+# encoding: UTF-8
+
+module NewAge
+  module RSpec
+    module Helpers
+
+      def self.all_together
+        space_or_not = [" ", ""]
+        
+        delims = %w{, . -} << " "
+        
+        y_specifier = ["year", "years", "y", "ys", "yrs", "" ]
+        m_specifier = ["month", "months", "m", "ms", "mths", "" ]
+        
+        yn = ((1..121).to_a.shuffle[0 .. y_specifier.length - 2 ]).shuffle 
+        
+        mn = ((1..11).to_a.shuffle[0 .. m_specifier.length - 2 ]).shuffle 
+        
+        n_spread = yn.flat_map{|y| mn.map{|m| [y,m] }} + (yn * (y_specifier.length - 1)).map{|y| [y,0]} + (mn * ( m_specifier.length - 1)).map{|m| [0,m]} 
+        
+        ymd = []; n_spread.zip( delims.cycle ).flatten.each_slice(3){|x| ymd << x }; ymd.uniq! 
+        
+        
+        inputs = ymd.map{|y,m,d| "#{y}#{space_or_not.sample}#{y_specifier.sample}#{d}#{m}#{space_or_not.sample}#{m_specifier.sample}" } 
+        # a real rag tag of inputs!
+        
+        all_together = Hash[ inputs.zip( ymd.zip ymd.map{|y,m,_| "#{y} years #{m} months"  } ) ]
+      end
+      
+    end
+  end  
+end

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification
+name: new-age
+version: !ruby/object:Gem::Version
+  version: 0.0.10
+  prerelease: 
+platform: ruby
+authors:
+- Iain Barnett
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: reek
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Handling the input and output of people's ages in years and months
+email:
+- iainspeed@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- NewAge.gemspec
+- README.markdown
+- Rakefile
+- lib/NewAge.rb
+- lib/NewAge/version.rb
+- lib/new-age.rb
+- spec/new_age_spec.rb
+- spec/rspec_helper.rb
+- spec/support/shared/contexts.rb
+homepage: https://github.com/yb66/NewAge
+licenses: []
+post_install_message: 
+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: NewAge
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Handling the input and output of people's ages in years and months
+test_files:
+- spec/new_age_spec.rb
+- spec/rspec_helper.rb
+- spec/support/shared/contexts.rb