greenwich 0.0.5 → 1.0.0

data/spec/greenwich/utilities_spec.rb

@@ -1,84 +1,178 @@
 require 'spec_helper'
 
 describe Greenwich::Utilities do
-  describe "#truncate" do
-    before { @expected_time = Time.utc(2011, 5, 13, 17, 31, 13, 0) }
+  describe '.get_time_zone_field' do
+    subject { Greenwich::Utilities.get_time_zone_field(name, columns) }
 
-    context "when passed a String" do
-      it "returns the correct time if no offset is given" do
-        truncated = Greenwich::Utilities.truncate("2011-05-13 17:31:13")
-        truncated.should eql @expected_time
+    let(:name) { 'foo_at' }
+
+    context 'when columns includes a field-specific time zone field' do
+      let(:columns) { %w(foo bar foo_at_time_zone) }
+
+      it 'is the field-specific time zone field' do
+        subject.should eql 'foo_at_time_zone'
       end
+    end
+
+    context 'when columns does not include a field-specific time zone field' do
+      context 'but does include the general time zone field' do
+        let(:columns) { %w(foo bar time_zone) }
 
-      it "returns the correct time if an offset is given" do
-        truncated = Greenwich::Utilities.truncate("2011-05-13 17:31:13 -0600")
-        truncated.should eql @expected_time
+        it 'is the general time zone field' do
+          subject.should eql 'time_zone'
+        end
+      end
+
+      context 'and does not include the general time zone field' do
+        let(:columns) { %w(foo bar) }
+
+        it 'is nil' do
+          subject.should be_nil
+        end
       end
     end
+  end
 
-    context "when passed a TimeWithZone" do
-      before { @time = Time.utc(2011, 5, 13, 17, 31, 13) }
+  describe '.get_time_zone' do
+    subject { Greenwich::Utilities.get_time_zone model, 'time_zone' }
 
-      it "returns the correct time if TimeWithZone is UTC" do
-        utc_time_zone = ActiveSupport::TimeZone.new('UTC')
-        time_with_zone = ActiveSupport::TimeWithZone.new(@time, utc_time_zone)
+    context 'when the object does not have a time zone' do
+      context 'because it does not exist' do
+        let(:model) { stub :time_zone => nil }
 
-        truncated = Greenwich::Utilities.truncate(time_with_zone)
-        truncated.should eql @expected_time
+        it 'is nil' do
+          subject.should be_nil
+        end
       end
 
-      it "returns the correct time if TimeWithZone is not UTC" do
-        alaskan_time_zone = ActiveSupport::TimeZone.new('Alaska')
-        time_with_zone = ActiveSupport::TimeWithZone.new(nil, alaskan_time_zone, @time)
+      context 'because it cannot be found' do
+        let(:model) { Object.new.stub(:time_zone).and_raise NoMethodError }
 
-        truncated = Greenwich::Utilities.truncate(time_with_zone)
-        truncated.should eql @expected_time
+        it 'is nil' do
+          subject.should be_nil
+        end
+      end
+
+      context 'because it is not valid' do
+        let(:model) { stub :time_zone => "Look at me! I'm an invalid time zone!" }
+
+        it 'is nil' do
+          subject.should be_nil
+        end
       end
     end
 
-    context "when passed a DateTime" do
-      it "returns the correct time if DateTime is UTC" do
-        datetime = DateTime.civil(2011, 5, 13, 17, 31, 13, 0)
+    context 'when the object does have a time zone' do
+      context 'because it is a time zone' do
+        let(:model) { stub :time_zone => ActiveSupport::TimeZone.new('Alaska') }
 
-        truncated = Greenwich::Utilities.truncate(datetime)
-        truncated.should eql @expected_time
+        it 'is the proper time zone object' do
+          subject.should eql ActiveSupport::TimeZone.new('Alaska')
+        end
       end
 
-      it "returns the correct time if DateTime is not UTC" do
-        datetime = DateTime.civil(2011, 5, 13, 17, 31, 13, -0.25)
+      context 'because it is a valid time zone string' do
+        let(:model) { stub :time_zone => 'Alaska' }
 
-        truncated = Greenwich::Utilities.truncate(datetime)
-        truncated.should eql @expected_time
+        it 'is the proper time zone object' do
+          subject.should eql ActiveSupport::TimeZone.new('Alaska')
+        end
       end
     end
   end
 
-  describe "#get_time_zone" do
-    context "when passed a valid time zone" do
-      it "returns that time zone" do
-        time_zone = Greenwich::Utilities.get_time_zone(nil, 'foo')
-        time_zone.should eql 'foo'
+  describe '.coerce_to_time_zone' do
+    subject { Greenwich::Utilities.coerce_to_time_zone(value) }
+
+    context 'when the value is nil' do
+      let(:value) { nil }
+
+      it 'is nil' do
+        subject.should be_nil
       end
     end
 
-    context "when not passed a time zone" do
-      before { @time = Time.utc(2011, 5, 13, 17, 31, 13) }
+    context 'when the value is blank' do
+      let(:value) { '' }
+
+      it 'is nil' do
+        subject.should be_nil
+      end
+    end
 
-      context "and passed a TimeWithZone for the time" do
-        it "returns the time zone associated with the time" do
-          alaskan_time_zone = ActiveSupport::TimeZone.new('Alaska')
-          time_with_zone = ActiveSupport::TimeWithZone.new(nil, alaskan_time_zone, @time)
+    context 'when the value is not the name of a valid time zone' do
+      let(:value) { 'foo' }
 
-          time_zone = Greenwich::Utilities.get_time_zone(time_with_zone, nil)
-          time_zone.should eql alaskan_time_zone
-        end
+      it 'is nil' do
+        subject.should be_nil
+      end
+    end
 
-        it "returns the time zone associated with the time" do
-          utc_time_zone = ActiveSupport::TimeZone.new('UTC')
+    context 'when the value is the name of a valid time zone' do
+      let(:value) { 'Alaska' }
 
-          time_zone = Greenwich::Utilities.get_time_zone(@time, nil)
-          time_zone.should eql utc_time_zone
-        end
+      it 'is the corresponding TimeZone' do
+        subject.should eql ActiveSupport::TimeZone.new('Alaska')
+      end
+    end
+
+    context 'when the value is a time zone' do
+      let(:value) { ActiveSupport::TimeZone.new('Alaska') }
+
+      it 'is the time zone' do
+        subject.should eql value
+      end
+    end
+  end
+
+  describe '.coerce_to_time_without_zone' do
+    subject { Greenwich::Utilities.coerce_to_time_without_zone value }
+
+    context 'when nil is passed in' do
+      let(:value) { nil }
+
+      it 'is nil' do
+        subject.should be_nil
+      end
+    end
+
+    context 'when something which cannot be converted to a time is passed in' do
+      let(:value) { 5 }
+
+      it 'is nil' do
+        subject.should be_nil
+      end
+    end
+
+    context 'when something which cannot be properly converted to a time is passed in' do
+      let(:value) { 'foo' }
+
+      it 'is nil' do
+        subject.should be_nil
+      end
+    end
+
+    context 'when a string that does not contain a UTC offset is passed in' do
+      let(:value) { '2012-01-02 12:59:01' }
+
+      it 'is the UTC representation of that time' do
+        subject.should eql Time.utc(2012, 1, 2, 12, 59, 1)
+      end
+    end
+
+    context 'when a string that does contain a UTC offset is passed in' do
+      let(:value) { '2012-01-02 12:59:01 -0800' }
+
+      it 'is the UTC representation of that time ignoring any time zone offset information' do
+        subject.should eql Time.utc(2012, 1, 2, 12, 59, 1)
+      end
+    end
+
+    context 'when a UTC time is passed in' do
+      let(:value) { Time.utc(2012, 1, 2, 12, 59, 1) }
+
+      it 'is the UTC representation of that time ignoring any time zone offset information' do
+        subject.should eql Time.utc(2012, 1, 2, 12, 59, 1)
       end
     end
   end

data/spec/spec_helper.rb

@@ -1,9 +1,3 @@
 Dir[File.dirname(__FILE__) + "/support/**/*.rb"].each {|f| require f}
 
 require 'greenwich'
-
-RSpec.configure do |config|
-  config.before do
-    load File.join(File.dirname(__FILE__), "model.rb")
-  end
-end

data/spec/support/focused.rb

@@ -0,0 +1,7 @@
+RSpec.configure do |config|
+  # Configure RSpec to run focused specs, and also respect the alias 'fit' for focused specs
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.filter_run       :focused => true
+  config.alias_example_to :fit, :focused => true
+  config.run_all_when_everything_filtered = true
+end

data/spec/support/pending.rb

@@ -0,0 +1,4 @@
+RSpec.configure do |config|
+  # Configure RSpec to respect the alias 'pit' for pending specs
+  config.alias_example_to :pit, :pending => true
+end

metadata

@@ -1,74 +1,155 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: greenwich
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 1.0.0
   prerelease: 
-  version: 0.0.5
 platform: ruby
-authors: 
-- thekompanee
+authors:
 - jfelchner
+- m5rk
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-09-30 00:00:00 -05:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2012-08-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
   prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: "3.0"
+      - !ruby/object:Gem::Version
+        version: '3.0'
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: bundler
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: tzinfo
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: "1.0"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
   type: :development
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: rspec
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: "2.6"
+      - !ruby/object:Gem::Version
+        version: '2.6'
   type: :development
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
   name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: "0.7"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id004
-description: Store all of your times in the database as UTC but want to give your users the ability to choose a custom time zone for each instance of a DateTime field?
-email: 
-- support@thekompanee.com
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Store all of your times in the database as UTC but want to give your
+  users the ability to choose a custom time zone for each instance of a DateTime field?
+email:
+- jeff+greenwich@chirrpy.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - README.md
 - LICENSE
-files: 
+files:
 - .gitignore
 - .rspec
 - .rvmrc
@@ -78,40 +159,50 @@ files:
 - Rakefile
 - greenwich.gemspec
 - lib/greenwich.rb
-- lib/greenwich/rails.rb
-- lib/greenwich/time_with_zone.rb
+- lib/greenwich/conversion.rb
+- lib/greenwich/time_zone.rb
 - lib/greenwich/utilities.rb
 - lib/greenwich/version.rb
+- spec/greenwich/conversion_spec.rb
 - spec/greenwich/utilities_spec.rb
 - spec/spec_helper.rb
-has_rdoc: true
-homepage: http://github.com/jfelchner/greenwich
+- spec/support/focused.rb
+- spec/support/pending.rb
+homepage: http://github.com/chirrpy/greenwich
 licenses: []
-
 post_install_message: 
-rdoc_options: 
+rdoc_options:
 - --charset = UTF-8
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1444067313011442519
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1444067313011442519
 requirements: []
-
 rubyforge_project: greenwich
-rubygems_version: 1.6.2
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Allowing users to select dates with custom time zones since 2011.
-test_files: 
+test_files:
+- spec/greenwich/conversion_spec.rb
 - spec/greenwich/utilities_spec.rb
 - spec/spec_helper.rb
+- spec/support/focused.rb
+- spec/support/pending.rb
+has_rdoc: