strftime 1.0.0 → 2.0.0.alpha

data/{README → README.md}

@@ -1,11 +1,14 @@
 # strftime
 
+It's pronounced "strftime", not "strftime".
+
 With strftime you'll have descriptions of time format directives at your fingertips in Ruby.
 
-`Strftime::Directives` contains a hash of details about these directives.
+`Strftime::Directive.all` contains an array of these directive objects
+holding a key, description and example.
 
-Just use `Strftime::Directives['%M']` to get a description and example, or use the shorthand method `strfd('M')`
+Just use `Strftime::Directives['%M']` to get a description and example, or use the shorthand method `strfd '%M'`
 
     Strftime::Directives['%M'].description #=> 'Minute of the hour'
 
-This might be useful for you, or for users of a system which are able to specify string formats for dates and times.
+This might be useful for you, or for users of a system which are able to specify string formats for dates and times.

data/bin/strfd

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+require 'date'
+require File.expand_path(File.dirname(__FILE__) + '/../lib/strftime.rb')
+
+# If the argument appears like "%y" just output the description
+# otherwise, find the format for the given date
+
+given_date = ARGV[0]
+
+if given_date
+  STDOUT.puts Strftime::InstructionSet.new(given_date).to_s
+else
+  STDOUT.puts Strftime::Directive.all.sort
+end

data/features/possible_options_for_date.feature

@@ -0,0 +1,47 @@
+Feature: using the command line
+  As a command line user
+  I want to see the time parsing directives for a date
+  so that I may better use and understand time parsing
+  
+    Scenario: Displaying all options
+      When I run "strfd"
+      Then the output should contain "%A"
+      And the output should contain "Saturday"
+      And the output should contain "English day of the week"
+      And the exit status should be 0
+    
+    Scenario: Displaying complex directives
+      When I run "strfd 'February 18, 2007'"
+      Then the output should contain "%B %d, %Y"
+      And the exit status should be 0
+      
+    Scenario: Four digit year directive
+      When I run "strfd '2010'"
+      Then the output should contain "%Y"
+      
+    Scenario: Time zone offset directive
+      When I run "strfd '+0000'"
+      Then the output should contain "%z"
+      
+    Scenario: Two digit directive
+      When I run "strfd '10'"
+      Then the output should contain "%g"
+      And the output should contain "%S"
+      And the output should contain "%H"
+      And the output should contain "%I"
+      And the output should contain "%U"
+      And the output should contain "%V"
+      And the output should contain "%k"
+      And the output should contain "%W"
+      And the output should contain "%m"
+      And the output should contain "%M"
+      And the output should contain "%C"
+      And the output should contain "%y"
+      And the output should contain "%d"
+      
+    Scenario: One digit directive
+      When I run "strfd '3'"
+      Then the output should contain "%e"
+      Then the output should contain "%l"
+      Then the output should contain "%u"
+      Then the output should contain "%w"

data/features/support/env.rb

@@ -0,0 +1,2 @@
+require 'aruba'
+require 'aruba/cucumber'

data/lib/kernel.rb

@@ -0,0 +1,9 @@
+module Kernel
+  def strfdirective(arg=nil)
+    return Strftime::Directive.all if arg == 'all'
+    if Strftime::Directive[arg]
+      Strftime::Directive[arg]
+    end
+  end
+  alias_method :strfd, :strfdirective
+end

data/lib/strftime.rb

@@ -1,67 +1,8 @@
+require 'date'
+require File.dirname(__FILE__) + '/strftime/version'
+require File.dirname(__FILE__) + '/strftime/directive'
+require File.dirname(__FILE__) + '/strftime/directive_matchers'
+require File.dirname(__FILE__) + '/strftime/instruction_set'
+require File.dirname(__FILE__) + '/kernel'
 module Strftime
-  Directives = Hash.new do |hash, key|
-    mod = ('%' << key.to_s)
-    hash[mod] if hash.keys.include?(mod)
-  end
-  Directives.merge!({
-    '%a' => { :description => 'The abbreviated weekday name', :example => "Sun"},
-    '%A' => { :description => 'The  full  weekday  name', :example => "Sunday"},
-    '%b' => { :description => 'The abbreviated month name', :example => "Jan"},
-    '%B' => { :description => 'The  full  month  name', :example => "January"},
-    '%c' => { :description => 'The preferred local date and time representation'},
-    '%C' => { :description => 'Century (20 in 2009)'},
-    '%d' => { :description => 'Day of the month', :example => "01..31"},
-    '%D' => { :description => 'Date (%m/%d/%y)'},
-    '%e' => { :description => 'Day of the month, blank-padded', :example => "1..31"},
-    '%F' => { :description => 'Equivalent to %Y-%m-%d (the ISO 8601 date format)'},
-    '%h' => { :description => 'Equivalent to %b'},
-    '%H' => { :description => 'Hour of the day, 24-hour clock', :example => "00..23"},
-    '%I' => { :description => 'Hour of the day, 12-hour clock', :example => "01..12)"},
-    '%j' => { :description => 'Day of the year', :example => "001..366"},
-    '%k' => { :description => 'hour, 24-hour clock, blank-padded', :example => "0..23"},
-    '%l' => { :description => 'hour, 12-hour clock, blank-padded', :example => "0..12"},
-    '%L' => { :description => 'Millisecond of the second', :example => "000..999"},
-    '%m' => { :description => 'Month of the year', :example => "01..12"},
-    '%M' => { :description => 'Minute of the hour', :example => "00..59"},
-    '%n' => { :description => 'Newline (\n)'},
-    '%N' => { :description => 'Fractional seconds digits, default is 9 digits (nanosecond)
-            %3N  millisecond (3 digits)
-            %6N  microsecond (6 digits)
-            %9N  nanosecond (9 digits)'},
-    '%p' => { :description => 'Meridian indicator', :example => "(``AM''  or  ``PM'')"},
-    '%P' => { :description => 'Meridian indicator', :example => "(``am''  or  ``pm'')"},
-    '%r' => { :description => 'time, 12-hour', :example => "same as %I:%M:%S %p"},
-    '%R' => { :description => 'time, 24-hour', :example => "%H:%M"},
-    '%s' => { :description => 'Number of seconds since 1970-01-01 00:00:00 UTC.'},
-    '%S' => { :description => 'Second of the minute', :example => "00..60"},
-    '%t' => { :description => 'Tab character', :example => "\t"},
-    '%T' => { :description => 'time, 24-hour', :example => "%H:%M:%S"},
-    '%u' => { :description => 'Day of the week as a decimal, Monday being 1.', :example => "1..7"},
-    '%U' => { :description => 'Week  number  of the current year,
-            starting with the first Sunday as the first
-            day of the first week', :example => "00..53"},
-    '%v' => { :description => 'VMS date', :example => "%e-%b-%Y"},
-    '%V' => { :description => 'Week number of year according to ISO 8601', :example => "01..53"},
-    '%W' => { :description => 'Week  number  of the current year,
-            starting with the first Monday as the first
-            day of the first week', :example => "00..53"},
-    '%w' => { :description => 'Day of the week', :example => "Sunday is 0, 0..6"},
-    '%x' => { :description => 'Preferred representation for the date alone, no time'},
-    '%X' => { :description => 'Preferred representation for the time alone, no date'},
-    '%y' => { :description => 'Year without a century', :example => "00..99"},
-    '%Y' => { :description => 'Year with century'},
-    '%z' => { :description => 'Time zone as  hour offset from UTC (e.g. +0900)'},
-    '%Z' => { :description => 'Time zone name'},
-    '%%' => { :description => "Literal ``%'' character"}
-  })
 end
-
-class Object
-  def strfd(arg=nil)
-    if arg
-      Strftime::Directives[arg]
-    else
-      Strftime::Directives
-    end
-  end
-end

data/lib/strftime/directive.rb

@@ -0,0 +1,261 @@
+module Strftime
+  class Directive
+    attr_accessor :key
+    attr_accessor :description
+    attr_accessor :example
+    attr_accessor :matcher
+    attr_accessor :related
+
+    @all = []
+
+    def initialize(key, options={})
+      self.key = key
+      self.description = options[:description]
+      self.example = options[:example]
+      self.matcher = options[:matcher]
+      self.related = options[:related]
+      self.class.all << self
+      self
+    end
+    def <=>(directive)
+      key <=> directive.key
+    end
+    def to_s
+%{    #{key}  #=> #{example}
+        #{description}}
+    end
+    class << self
+      attr_accessor :all
+      attr_reader :default_collection
+
+      def [](key)
+        all.find{|d| d.key == key}
+      end
+      
+      def matching(string)
+        Strftime::Directive.all.select{|d|
+          d.matcher.match(string)
+        }
+      end
+    end
+    @default_collection = {
+      '%A' => {:description => %{English day of the week}, 
+                :example => %{Saturday},
+                :matcher => Regexp.union(Date::DAYNAMES),
+                :related => ['%a']},
+                
+      '%a' => {:description => %{Abbreviated English day of the week}, 
+                :example => %{Sat},
+                :matcher => Regexp.union(Date::ABBR_DAYNAMES),
+                :related => %w{%A %d %e}},
+                
+      '%B' => {:description => %{English month of the year}, 
+                :example => %{December},
+                :matcher => Regexp.union(Date::MONTHNAMES.compact),
+                :related => %w{%b}},
+                
+      '%b' => {:description => %{English month of the year}, 
+                :example => %{Dec},
+                :matcher => Regexp.union(Date::ABBR_MONTHNAMES.compact),
+                :related => %w{%B %v}},
+                
+      '%C' => {:description => %{The century part of the year, zero-padded if necessary.}, 
+                :example => %{20},
+                :matcher => /\A\d\d\Z/,
+                :related => %w{%y %Y}},
+                
+      '%c' => {:description => %{This prints the date and time in a way that looks like the default string representation of Time, but without the timezone. Equivalent to '%a %b %e %H:%M:%S %Y'}, 
+                :example => %{Sat Dec 31 13:22:33 2005},
+                :matcher => "(#{Date::ABBR_DAYNAMES.join('|')}) (#{Date::ABBR_MONTHNAMES.compact.join('|')}) [123]\\d [012]\\d:\\d{2}:\\d{2} \\d{4}",
+                :related => %w{%a %b %e %H %M %S %Y}},
+                
+      '%D' => {:description => %{American-style short date format with two-digit year. Equivalent to "%m/%d/%y"}, 
+                :example => %{12/31/05},
+                :matcher => /[012]\d\/[012]\d\/\d{2}/,
+                :related => %w{%m %d %y %x}},
+                
+      '%d' => {:description => %{Day of the month, zero-padded}, 
+                :example => %{03},
+                :matcher => /[01]\d/,
+                :related => %w{%e}},
+                
+      '%e' => {:description => %{Day of the month, not zero-padded}, 
+                :example => %{3},
+                :matcher => /[123]?\d/,
+                :related => %w{%d %v}},
+                
+      '%F' => {:description => %{Short date format with 4-digit year.; equivalent to "%Y-%m-%d"}, 
+                :example => %{2005-12-31},
+                :matcher => /\d{4}-[01]\d-[0123]\d/,
+                :related => %w{%Y %m %d %D}},
+                
+      '%G' => {:description => %{Commercial year with century, zero-padded to a minimum of four digits and with a minus sign prepended for dates BCE. For the calendar year, use %Y)}, 
+                :example => %{2005},
+                :matcher => /\d{4}/,
+                :related => %w{%g %Y %y}},
+                
+      '%g' => {:description => %{Year without century, zero-padded to two digits}, 
+                :example => %{05},
+                :matcher => /\d{2}/,
+                :related => %w{%G %Y %y}},
+                
+      '%H' => {:description => %{Hour of the day, 24-hour clock, zero-padded to two digits}, 
+                :example => %{13},
+                :matcher => /[012]\d/,
+                :related => %w{%I}},
+                
+      '%h' => {:description => %{Abbreviated month of the year; the same as "%b"}, 
+                :example => %{Dec},
+                :matcher => Regexp.union(Date::ABBR_MONTHNAMES.compact),
+                :related => %w{%b}},
+                
+      '%I' => {:description => %{Hour of the day, 12-hour clock, zero-padded to two digits}, 
+                :example => %{01},
+                :matcher => /[01]\d/,
+                :related => %w{%H %l}},
+                
+      '%j' => {:description => %{Julian day of the year, padded to three digits (from 001 to 366)}, 
+                :example => %{365},
+                :matcher => /\d{3}/,
+                :related => %w{}},
+                
+      '%k' => {:description => %{Hour of the day, 24-hour clock, not zero-padded; like %H but with no padding}, 
+                :example => %{13},
+                :matcher => /\d?\d/,
+                :related => %w{%H}},
+                
+      '%l' => {:description => %{Hour of the day, 12-hour clock, not zero-padded; like %I but with no padding}, 
+                :example => %{1},
+                :matcher => /\d?\d/,
+                :related => %w{%I}},
+                
+      '%M' => {:description => %{Minute of the hour, padded to two digits}, 
+                :example => %{22},
+                :matcher => /\d{2}/,
+                :related => %w{}},
+                
+      '%m' => {:description => %{Month of the year, padded to two digits}, 
+                :example => %{12},
+                :matcher => /\d{2}/,
+                :related => %w{}},
+                
+      '%n' => {:description => %{A newline; don't use this; just put a newline in the formatting string}, 
+                :example => %{\n},
+                :matcher => /.+/m,
+                :related => %w{}},
+                
+      '%P' => {:description => %{Lowercase meridian indicator ("am" or "pm")}, 
+                :example => %{pm},
+                :matcher => /am|pm/,
+                :related => %w{%p}},
+                
+      '%p' => {:description => %{Upper meridian indicator. Like %P, except gives "AM" or "PM"; yes, the uppercase P gives the lowercase meridian, and vice versa}, 
+                :example => %{PM},
+                :matcher => /PM|AM/,
+                :related => %w{%P}},
+                
+      '%R' => {:description => %{Short 24-hour time format; equivalent to "%H:%M"}, 
+                :example => %{13:22},
+                :matcher => /[012]\d:\d{2}/,
+                :related => %w{}},
+                
+      '%r' => {:description => %{Long 12-hour time format; equivalent to "%I:%M:%S %p"}, 
+                :example => %{01:22:33 PM},
+                :matcher => /[01]\d:\d{2}:\d{2} (AM|PM)/,
+                :related => %w{}},
+                
+      '%S' => {:description => %{Second of the minute, zero-padded to two digits}, 
+                :example => %{33},
+                :matcher => /\d{2}/,
+                :related => %w{}},
+                
+      '%s' => {:description => %{Seconds since the Unix epoch}, 
+                :example => %{1136053353},
+                :matcher => /\d+/,
+                :related => %w{}},
+                
+      '%T' => {:description => %{Long 24-hour time format; equivalent to "%H:%M:%S"}, 
+                :example => %{13:22:33},
+                :matcher => /[012]\d:\d{2}:\d{2}/,
+                :related => %w{%X}},
+                
+      '%t' => {:description => %{A tab; don't use this; just put a tab in the formatting string}, 
+                :example => %{\t},
+                :matcher => /\Z\A/,
+                :related => %w{}},
+                
+      '%U' => {:description => %{Calendar week number of the year: assumes that the first week of the year starts on the first Sunday; if a date comes before the first Sunday of the year, it's counted as part of "week zero" and "00" is returned}, 
+                :example => %{52},
+                :matcher => /\d{2}/,
+                :related => %w{}},
+                
+      '%u' => {:description => %{Commercial weekday of the year, from 1 to 7, with Monday being day 1}, 
+                :example => %{6},
+                :matcher => /[1-7]/,
+                :related => %w{}},
+                
+      '%V' => {:description => %{Commercial week number of the year}, 
+                :example => %{52},
+                :matcher => /\d{2}/,
+                :related => %w{%W}},
+                
+      '%W' => {:description => %{The same as %V, but if a date is before the first Monday of the year, it's counted as part of "week zero" and "00" is returned}, 
+                :example => %{52},
+                :matcher => /\d{2}/,
+                :related => %w{%V}},
+                
+      '%w' => {:description => %{Calendar day of the week, from 0 to 6, with Sunday being day 0}, 
+                :example => %{6},
+                :matcher => /\A[0-6]\Z/,
+                :related => %w{}},
+                
+      '%X' => {:description => %{Preferred representation for the time; equivalent to "%H:%M:%S"}, 
+                :example => %{13:22:33},
+                :matcher => /[012]\d:\d{2}:\d{2}/,
+                :related => %w{%H %M %S %T}},
+                
+      '%x' => {:description => %{Preferred representation for the date; equivalent to "%m/%d/%y"}, 
+                :example => %{12/31/05},
+                :matcher => /[012]\d\/[012]\d\/\d{2}/,
+                :related => %w{%m %d %y %D}},
+                
+      '%Y' => {:description => %{Year with century, zero-padded to four digits and with a minus sign prepended for dates BCE}, 
+                :example => %{2005},
+                :matcher => /-?\d{4}/,
+                :related => %w{%y}},
+                
+      '%y' => {:description => %{Year without century, zero-padded to two digits}, 
+                :example => %{05},
+                :matcher => /\A\d{2}\Z/,
+                :related => %w{%Y}},
+                
+      '%Z' => {:description => %{The timezone abbreviation (Time) or GMT offset (Date). Date will use "Z" instead of "+0000" if a time is in GMT}, 
+                :example => %{"GMT" for Time, "Z" for Date},
+                :matcher => Regexp.new(Regexp.union(Date::Format::ZONES.sort_by{|z| z[0].length}.reverse.collect{|f| f[0]}).source,true),
+                :related => %w{%z}},
+                
+      '%z' => {:description => %{The timezone as a GMT offset}, 
+                :example => %{+0000},
+                :matcher => /\A\\+\d{4}\Z/,
+                :related => %w{}},
+                
+      '%%' => {:description => %{A literal percent sign}, 
+                :example => %{%},
+                :matcher => /\A%\Z/,
+                :related => %w{}},
+                
+      '%v' => {:description => %{European-style date format with month abbreviation; equivalent to "%e-%b-%Y"}, 
+                :example => %{31-Dec-2005},
+                :matcher => Regexp.new("[123]?\\d-(#{Date::ABBR_MONTHNAMES.compact.join('|')})-\\d{4}"),
+                :related => %w{%e %b %Y}},
+                
+      '%+' => {:description => %{Prints a Dateobject as though it were a Timeobject converted to a string; like %c, but includes the timezone information; equivalent to "%a %b %e %H:%M:%S %Z %Y"}, 
+                :example => %{Sat Dec 31 13:22:33 Z 2005},
+                :matcher => Regexp.new("#{Regexp.union(Date::ABBR_DAYNAMES)}\ #{Regexp.union(Date::ABBR_MONTHNAMES.compact)}\ [123]?\\d\ [012]\\d:\\d{2}:\\d{2}\ #{Regexp.new(Regexp.union(Date::Format::ZONES.sort_by{|z| z[0].length}.reverse.collect{|f| f[0]}).source,true).source}\\d{4}"),
+                :related => %w{%a %b %e %H %M %S %Z %Y}}
+    }.each do |k,v|
+      Strftime::Directive.new(k, v)
+    end
+    @default_collection = all
+  end
+end

data/lib/strftime/directive_matchers.rb

@@ -0,0 +1,7 @@
+module Strftime
+  module DirectiveMatchers
+    MONTHNAMES_REGEXP = Regexp.new('('<<Date::MONTHNAMES.compact.join('|')<<')')
+    TIMEZONE_OFFSET_REGEXP = /\+\d{4}/
+    FOUR_DIGIT_YEAR_REGEXP = /\d{4}/
+  end
+end

data/lib/strftime/instruction_set.rb

@@ -0,0 +1,46 @@
+module Strftime
+  class InstructionSet
+    include Strftime::DirectiveMatchers
+    attr_reader :example
+    attr_writer :example
+    attr_reader :instructions
+    attr_writer :instructions
+    def initialize(given)
+      self.example = given
+      self.instructions = []
+      test_date = given.dup
+      
+      # Single replacements
+      test_date.gsub!(MONTHNAMES_REGEXP,'%B')
+      test_date.gsub!(TIMEZONE_OFFSET_REGEXP,'%z')
+      test_date.gsub!(FOUR_DIGIT_YEAR_REGEXP,'%Y')
+      
+      # 2 digit options
+      two_digit_directives = Strftime::Directive.all.select{|d| 
+        d.example.match(/^\d{2}$/) rescue false
+      }
+      test_date.scan(/\d\d/).each do |found|
+        two_digit_directives.each do |directive|
+          self.instructions << test_date.sub(Regexp.new(found),directive.key)
+        end
+      end
+      one_character_directives = Strftime::Directive.all.select{|d| 
+        d.example.match(/^[^%\W]{1}$/) rescue false
+      }
+      test_date.scan(/\d/).each do |found|
+        one_character_directives.each do |directive|
+          self.instructions << test_date.sub(Regexp.new(found),directive.key)
+        end
+      end
+      self.instructions << test_date if self.instructions.empty?
+
+      self.instructions.map!{|i| %{#{i} #=> #{Time.now.strftime(i)}}}
+    end
+    
+    def to_s
+      content = 'Using the current time as the formatting date:'
+      self.instructions.join('
+')
+    end
+  end
+end

data/lib/strftime/version.rb

@@ -1,3 +1,3 @@
 module Strftime
-  VERSION = "1.0.0"
-end
+  VERSION = "2.0.0.alpha"
+end

data/spec/lib/strftime/directive_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+describe Strftime::Directive do
+  context '.matching' do
+    it 'should return all Directives that match the given string' do
+      Strftime::Directive.all = Strftime::Directive.default_collection
+      debugger
+      Strftime::Directive.matching('+1234').length.should == 1
+    end
+  end
+  context '.initialize' do
+    it 'should require a key' do
+      lambda{ Strftime::Directive.new }.should raise_error
+    end
+    it 'should set the first argument to the key' do
+      d = Strftime::Directive.new('%A')
+      d.key.should == '%A'
+    end
+    it 'should set the description from the given :description' do
+      d = Strftime::Directive.new('%B', :description => 'B directive')
+      d.description.should == 'B directive'
+    end
+    it 'should set the example from the given :example' do
+      d = Strftime::Directive.new('%C', :example => 'some format display')
+      d.example.should == 'some format display'
+    end
+    it "should set the matcher to a regular expression which matches it's replaceable text" do
+      d = Strftime::Directive.new('%D', :matcher => /ZOMG/)
+      d.matcher.should == /ZOMG/
+    end
+  end
+  context '.all=' do
+    it 'should set the collection of Strftime::Directive objects' do
+      Strftime::Directive.all.size.should be > 0
+      Strftime::Directive.all = []
+      Strftime::Directive.all.size.should == 0
+    end
+  end
+  context '.all' do
+    it 'should return a collection of all Strftime::Directive objects' do
+      directives = []
+      Strftime::Directive.all = []
+      directives << Strftime::Directive.new('%ZZ')
+      Strftime::Directive.all.should =~ directives
+    end
+  end
+  context '.default_collection' do
+    it 'should return the standard collection of Strftime::Directive objects' do
+      defaults = Strftime::Directive.default_collection
+    end
+    it 'should not be settable' do
+      lambda{ Strftime::Directive.default_collection = [] }.should raise_error(NoMethodError)
+    end
+  end
+  context '.[]' do
+    it 'should return a Directive with the key of the given argument' do
+      q = Strftime::Directive.new('%q')
+      Strftime::Directive['%q'].should == q
+    end
+  end
+  context '#<=>' do
+    it 'should compare the key to the given directive key' do
+      a = Strftime::Directive.new('%a')
+      b = Strftime::Directive.new('%b')
+      (a <=> b).should == -1
+    end
+  end
+  context '#to_s' do
+    it 'should output formatted contents' do
+      c = Strftime::Directive.new('%c', :description => 'Test sample.', :example => 'output something!')
+      c.to_s.should == '    %c  #=> output something!
+        Test sample.'
+    end
+  end
+end

data/spec/lib/strftime/instruction_set_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Strftime::InstructionSet do
+  context '.initialize' do
+    Strftime::Directive.all = Strftime::Directive.default_collection
+    it 'should require an example string' do
+      lambda{ Strftime::InstructionSet.new }.should raise_error
+    end
+    it 'should have a collection of instructions' do
+      Array.should === Strftime::InstructionSet.new('test').instructions
+    end
+  end
+  
+  context '#to_s' do
+    it 'should output all instructions joined by a new line' do
+      test_set = Strftime::InstructionSet.new('January 01')
+      test_set.to_s.should == test_set.instructions.join('
+')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'rspec'
+require 'strftime'
+
+Rspec.configure do |c|
+  c.mock_with :rspec
+end

data/strftime.gemspec

@@ -16,18 +16,22 @@ Gem::Specification.new do |s|
   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"]
-  
+
+  s.add_development_dependency('rspec', '~> 2.3.0')
+  s.add_development_dependency('aruba', '~> 0.3.2')
+
   s.post_install_message = %{
   Thanks for installing strftime. You can use these methods to
   better understand the formats used in Date and Time strftime
-  
-  Strftime::Directives       #=> a full hash of directives
-  Strftime::Directives['%y'] #=> a hash of description and 
-                             #   optional example value
-                             
-  Strftime::Directives['y']  #=> optionally exclude the %
-   
-  strfd                      #=> shorthand to get directives
-  strfd('y')                 #=> shorthand to get details
+
+  Strftime::Directive.all                #=> a full array of directives
+  Strftime::Directive['%y']              #=> a Strftime::Directive with
+                                         #   a key of the given argument
+
+  Strftime::Directive.default_collection #=> standard directives
+                                         #   unchanged by your code
+
+  strfd                                  #=> shorthand to get directives
+  strfd('%y')                            #=> shorthand to get details
   }
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification 
 name: strftime
 version: !ruby/object:Gem::Version 
-  hash: 23
-  prerelease: false
+  hash: -1851332194
+  prerelease: true
   segments: 
-  - 1
+  - 2
   - 0
   - 0
-  version: 1.0.0
+  - alpha
+  version: 2.0.0.alpha
 platform: ruby
 authors: 
 - Jim Gay
@@ -15,15 +16,46 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-04 00:00:00 -04:00
+date: 2011-01-14 00:00:00 -05:00
 default_executable: 
-dependencies: []
-
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: aruba
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 0
+        - 3
+        - 2
+        version: 0.3.2
+  type: :development
+  version_requirements: *id002
 description: Convenient list of strftime format directives
 email: 
 - jim@saturnflyer.com
-executables: []
-
+executables: 
+- strfd
 extensions: []
 
 extra_rdoc_files: []
@@ -32,16 +64,26 @@ files:
 - .gitignore
 - Gemfile
 - LICENSE
-- README
+- README.md
 - Rakefile
+- bin/strfd
+- features/possible_options_for_date.feature
+- features/support/env.rb
+- lib/kernel.rb
 - lib/strftime.rb
+- lib/strftime/directive.rb
+- lib/strftime/directive_matchers.rb
+- lib/strftime/instruction_set.rb
 - lib/strftime/version.rb
+- spec/lib/strftime/directive_spec.rb
+- spec/lib/strftime/instruction_set_spec.rb
+- spec/spec_helper.rb
 - strftime.gemspec
 has_rdoc: true
 homepage: http://rubygems.org/gems/strftime
 licenses: []
 
-post_install_message: "\n  Thanks for installing strftime. You can use these methods to\n  better understand the formats used in Date and Time strftime\n  \n  Strftime::Directives       #=> a full hash of directives\n  Strftime::Directives['%y'] #=> a hash of description and \n                             #   optional example value\n                             \n  Strftime::Directives['y']  #=> optionally exclude the %\n   \n  strfd                      #=> shorthand to get directives\n  strfd('y')                 #=> shorthand to get details\n  "
+post_install_message: "\n  Thanks for installing strftime. You can use these methods to\n  better understand the formats used in Date and Time strftime\n\n  Strftime::Directive.all                #=> a full array of directives\n  Strftime::Directive['%y']              #=> a Strftime::Directive with\n                                         #   a key of the given argument\n\n  Strftime::Directive.default_collection #=> standard directives\n                                         #   unchanged by your code\n\n  strfd                                  #=> shorthand to get directives\n  strfd('%y')                            #=> shorthand to get details\n  "
 rdoc_options: []
 
 require_paths: 
@@ -58,12 +100,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version 
-      hash: 3
+      hash: 25
       segments: 
-      - 0
-      version: "0"
+      - 1
+      - 3
+      - 1
+      version: 1.3.1
 requirements: []
 
 rubyforge_project: 
@@ -71,5 +115,9 @@ rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Convenient list of strftime format directives
-test_files: []
-
+test_files: 
+- features/possible_options_for_date.feature
+- features/support/env.rb
+- spec/lib/strftime/directive_spec.rb
+- spec/lib/strftime/instruction_set_spec.rb
+- spec/spec_helper.rb