date_utc_parser 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

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

data/Gemfile

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

data/README.md

@@ -0,0 +1,53 @@
+# Tired of Dating?
+
+Date UTC Parser was written so that I could guarantee to either get back a UTC Date Time object, or nil - while writing some API's for mobile apps.  That's all I wanted, and that's what this guy does.
+
+Along with that, it will return the humanized UTC example string, and it contains the regex that will match that string, can be used for error handling.
+
+# Using It
+
+Install it as a gem
+
+```bash
+gem install date_utc_parser
+```
+
+Require it in your app
+
+```ruby
+require 'date_utc_parser'
+```
+
+Start using it.
+
+# Some Examples
+
+## Time Object to UTC Time Object
+
+```ruby
+unparsed_time = Time.now
+unparsed_time.utc? #=> false 
+parsed_time = DateUtcParser.parse unparsed_time # => 2012-07-07 18:59:02 UTC 
+parsed_time.utc? #=> true 
+```
+
+## UTC Time String to UTC Time Object
+
+```ruby
+unparsed_time = "2012-07-08T12:13:14Z"
+parsed_time = DateUtcParser.parse unparsed_time # => 2012-07-08 12:13:14 UTC
+parsed_time.utc? #=> true 
+```
+
+## Everything else
+
+```ruby
+unparsed_time = "white russian"
+parsed_time = DateUtcParser.parse unparsed_time # => nil
+```
+
+# Contribute
+
+Fork it, branch your topic, test it, make a pull request.
+
+I suggest you bounce your idea off of me first so you don't make wasted effort.

data/Rakefile

@@ -0,0 +1,12 @@
+require 'bundler/gem_tasks'
+
+begin
+  require 'rspec/core/rake_task'
+
+  desc 'Default: run specs.'
+  task :default => :spec
+
+  desc "Run specs"
+  RSpec::Core::RakeTask.new 
+rescue LoadError
+end

data/date_utc_parser.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "date_utc_parser/version"
+
+Gem::Specification.new do |s|
+  s.name        = "date_utc_parser"
+  s.version     = DateUtcParser::VERSION
+  s.authors     = ["Matt Simpson"]
+  s.email       = ["matt.simpson3@gmail.com"]
+  s.homepage    = "http://github.com/ionicmobile/date_utc_parser"
+  s.summary     = %q{Make working with UTC Time more fun}
+  s.description = %q{Takes an object and returns the equivalent UTC Time object}
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {spec}/*`.split("\n")
+  s.require_paths = ["lib"]
+  s.required_ruby_version = "~> 1.9.2"
+
+  s.add_development_dependency "rspec", "2.10.0"
+end

data/lib/date_utc_parser/version.rb

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

data/lib/date_utc_parser.rb

@@ -0,0 +1,32 @@
+require "date_utc_parser/version"
+require 'time'
+
+module DateUtcParser
+  def self.parse(date)
+    date.is_a?(Time) ? parse_from_time(date) : parse_from_string(date)
+  end
+
+  def self.parse_from_string(date)
+    Time.parse(date) if date && date =~ iso8601_pattern
+  rescue ArgumentError
+    # date could not be parsed
+  end
+
+  # http://www.w3.org/TR/NOTE-datetime
+  # http://tools.ietf.org/html/rfc3339
+  # 
+  # example: 1994-11-05T13:15:30Z
+  #
+  def self.iso8601_pattern
+    /\A\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z\Z/
+  end
+
+  def self.iso8601_humanized_pattern
+    "YYYY-MM-DDTmm:dd:ssZ"
+  end
+
+  def self.parse_from_time(date)
+    date.utc? ? date : date.utc
+  end
+end
+

data/spec/lib/date_utc_parser_spec.rb

@@ -0,0 +1,65 @@
+require_relative '../../lib/date_utc_parser'
+require 'time'
+
+describe DateUtcParser, "Parsing:" do
+  subject { described_class.parse(date) }
+
+  context "when there is no date given" do
+    let(:date) { nil }
+
+    it 'returns nil' do
+      subject.should be_nil
+    end
+  end
+
+  context "when the date is a string, is a valid date time format, but is not utc" do
+    let(:date) { "2012-05-14 10:49:38 -0500" }
+
+    it 'returns nil' do
+      subject.should be_nil
+    end
+  end
+
+  context "when the date is a string, is a valid format, but is not a valid date" do
+    let(:date) { "2012-50-12T20:46:51Z" }
+
+    it 'returns nil' do
+      subject.should be_nil
+    end
+  end
+
+  context "when the date is a string, but is not a valid date time format" do
+    let(:date) { "asdf" }
+
+    it 'returns nil' do
+      subject.should be_nil
+    end
+  end
+
+  context "when the date is a valid date time format, and is a valid date, and is utc" do 
+    let(:date) { "2012-05-12T20:46:51Z" }
+
+    it 'returns the parsed date' do
+      subject.should == Time.parse(date)
+    end
+  end
+
+  context "when the date is already a Time object" do
+    context 'and is a utc date' do
+      let(:date) { Time.now.utc }
+
+      it "returns the time object" do
+        subject.should == date
+      end
+    end
+
+    context 'but is not a utc date' do
+      let(:date) { Time.now }
+
+      it "returns the time object as utc" do
+        subject.utc?.should be_true
+        subject.should == date.utc
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: date_utc_parser
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Matt Simpson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-07-07 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 10
+        - 0
+        version: 2.10.0
+  type: :development
+  version_requirements: *id001
+description: Takes an object and returns the equivalent UTC Time object
+email: 
+- matt.simpson3@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- README.md
+- Rakefile
+- date_utc_parser.gemspec
+- lib/date_utc_parser.rb
+- lib/date_utc_parser/version.rb
+- spec/lib/date_utc_parser_spec.rb
+has_rdoc: true
+homepage: http://github.com/ionicmobile/date_utc_parser
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ~>
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 9
+      - 2
+      version: 1.9.2
+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: Make working with UTC Time more fun
+test_files: []
+