stamp 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+.bundle
+pkg/*

data/.rvmrc

@@ -0,0 +1 @@
+rvm use 1.9.2@stamp

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,27 @@
+PATH
+  remote: .
+  specs:
+    stamp (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    builder (3.0.0)
+    cucumber (1.0.0)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.2)
+      gherkin (~> 2.4.1)
+      json (>= 1.4.6)
+      term-ansicolor (>= 1.0.5)
+    diff-lcs (1.1.2)
+    gherkin (2.4.1)
+      json (>= 1.4.6)
+    json (1.5.3)
+    term-ansicolor (1.0.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  cucumber
+  stamp!

data/README.md

@@ -0,0 +1,35 @@
+# stamp
+
+Format dates and times based on examples, not arcane strftime directives.
+
+[![Build Status](http://travis-ci.org/jeremyw/stamp.png)](http://travis-ci.org/jeremyw/stamp)
+
+## Installation
+
+Just `gem install stamp`, or add stamp to your Gemfile and `bundle install`.
+
+## Usage
+
+```ruby
+date = Date.new(2011, 6, 9)
+date.stamp("January 1, 1999")       # June 6, 2011
+date.stamp("Jan 09, 1999")          # Jun 06, 2011
+date.stamp("Jan 1")                 # Jun 6
+```
+
+More coming soon, including time formats by example.
+
+## Contributing to stamp
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2011 Jeremy Weiskotten (@doctorzaius). See LICENSE.txt for
+further details.

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'cucumber/rake/task'
+
+Cucumber::Rake::Task.new(:features)
+
+task :default => :features

data/features/stamp.feature

@@ -0,0 +1,20 @@
+Feature: Stamping a date
+  In order to format dates in a more programmer-friendly way
+  the stamp method
+  formats a date given a human-readable example.
+
+  Scenario Outline: Various examples
+    Given the date December 9, 2011
+    When I stamp the example "<example>"
+    Then I produce "<output>"
+    And I like turtles
+
+    Examples:
+      | example      | output       |
+      | pass-through | pass-through |
+      | January      | December     |
+      | Jan          | Dec          |
+      | Jan 1        | Dec  9       |
+      | Jan 01       | Dec 09       |
+      | Jan 10       | Dec 09       |
+      | Jan 1, 1999  | Dec  9, 2011 |

data/features/step_definitions/stamp_steps.rb

@@ -0,0 +1,13 @@
+Given /^the date (\w+) (\d+), (\d{4})$/ do |month_name, day, year|
+  month = Date::MONTHNAMES.index(month_name) || Date::ABBR_MONTHNAMES.index(month_name)
+  assert (1..12).include?(month), "Invalid month: #{month_name}"
+  @date = Date.new(year.to_i, month, day.to_i)
+end
+
+When /^I stamp the example "([^"]*)"$/ do |example|
+  @formatted_date = @date.stamp(example)
+end
+
+Then /^I produce "([^"]*)"$/ do |expected|
+  assert_equal expected, @formatted_date
+end

data/features/step_definitions/turtle_steps.rb

@@ -0,0 +1,5 @@
+# http://www.youtube.com/watch?v=CMNry4PE93Y
+Then /^I like turtles$/ do
+  turtles_are_awesome = true
+  assert turtles_are_awesome
+end

data/features/support/env.rb

@@ -0,0 +1,14 @@
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'stamp'
+
+require 'test/unit/assertions'
+World(Test::Unit::Assertions)

data/lib/stamp.rb

@@ -0,0 +1,56 @@
+require "stamp/version"
+require "date"
+
+module Stamp
+  def self.included(klass)
+    klass.class_eval do
+      # extend ClassMethods
+      include InstanceMethods
+    end
+  end
+
+  # module ClassMethods
+  # end
+
+  module InstanceMethods
+    MONTHNAMES_REGEXP = /(#{Date::MONTHNAMES.compact.join('|')})/i
+    ABBR_MONTHNAMES_REGEXP = /(#{Date::ABBR_MONTHNAMES.compact.join('|')})/i
+
+    def stamp(example)
+      strftime(strftime_directives(example))
+    end
+
+    def strftime_directives(example)
+      directives = []
+      terms = example.split(/\b/)
+
+      terms.each_with_index do |term, index|
+        previous_term = (index == 0)            ? nil : terms[index - 1]
+        next_term     = (index == terms.size-1) ? nil : terms[index + 1]
+
+        directives << (strftime_directive(term, previous_term, next_term) || term)
+      end
+
+      directives.join
+    end
+    private :strftime_directives
+
+    def strftime_directive(term, previous_term=nil, next_term=nil)
+      case term
+      when MONTHNAMES_REGEXP
+        '%B'
+      when ABBR_MONTHNAMES_REGEXP
+        '%b'
+      when /\d{4}/
+        '%Y'
+      when /\d{2}/
+        '%d'
+      when /\d{1}/
+        '%e'
+      end
+    end
+    private :strftime_directive
+  end
+end
+
+Date.send(:include, ::Stamp)

data/lib/stamp/version.rb

@@ -0,0 +1,3 @@
+module Stamp
+  VERSION = "0.0.1"
+end

data/stamp.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "stamp/version"
+
+Gem::Specification.new do |s|
+  s.name        = "stamp"
+  s.version     = Stamp::VERSION
+  s.authors     = ["Jeremy Weiskotten"]
+  s.email       = ["jeremy@weiskotten.com"]
+  s.homepage    = "https://github.com/jeremyw/stamp"
+  s.summary     = %Q{Date and time formatting for humans.}
+  s.description = %Q{Format dates and times based on examples, not arcane strftime directives.}
+
+  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"]
+
+  s.add_development_dependency "cucumber"
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: stamp
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jeremy Weiskotten
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-29 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Format dates and times based on examples, not arcane strftime directives.
+email: 
+- jeremy@weiskotten.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- features/stamp.feature
+- features/step_definitions/stamp_steps.rb
+- features/step_definitions/turtle_steps.rb
+- features/support/env.rb
+- lib/stamp.rb
+- lib/stamp/version.rb
+- stamp.gemspec
+has_rdoc: true
+homepage: https://github.com/jeremyw/stamp
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Date and time formatting for humans.
+test_files: 
+- features/stamp.feature
+- features/step_definitions/stamp_steps.rb
+- features/step_definitions/turtle_steps.rb
+- features/support/env.rb