greenwich 0.0.1

data/.gitignore

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

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2011 The Kompanee - Jeff Felchner
+
+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.

data/README.md

@@ -0,0 +1,116 @@
+Greenwich...
+================================
+
+...has been helping Rails developers work with custom time zones since 2011.
+
+![Greenwich](http://www.thekompanee.com/public_files/greenwich.jpg)
+
+Rails 2.1 brought much-needed improvements to working with time zones in Rails.
+But even now, with Rails 3 out and kicking ass, allowing users to _specify_ the time
+zone they would like to use for a given date is still a PITA.
+
+Enter Greenwich
+
+You too can now give your users the **POWER** of choosing a time zone via a
+standard web form.  Maybe you have a system that allows people to enter appointments
+for Widgets, Inc.  Since they make the best widgets in the world, they're very popular
+internationally.  You would like a system which allows your users to enter not just the
+_time_ of an appointment but also the time _zone_ in which the appointment is located.
+
+Still interested?  Read on intrepid traveler.
+
+Installation
+--------------------------------
+
+    gem install greenwich
+
+Initialization
+--------------------------------
+
+You add Greenwich to your models like so:
+
+    date_with_time_zone :field_name
+
+By default Greenwich looks for a few different columns in your model depending on the
+field name you passed in.  Let's look at some examples.
+
+Meta-Programming Magic
+--------------------------------
+
+** DateTime Field Lookup **
+Greenwich will lookup `:field_name` based on a couple different standard column suffixes.
+
+  * `_at`
+  * `_datetime`
+
+For example, if you specify:
+
+    date_with_time_zone :start
+
+Greenwich will look for the columns `start_at` and `start_datetime` (in that order).
+
+** Time Zone Field Lookup **
+Time Zone lookups default to a per-field or per-model specification.  If you specify:
+
+    date_with_time_zone :start
+
+Greenwich will lookup the time zone from `:start_time_zone` first, and if it doesn't
+find a field by that name, it will use `:time_zone`.
+
+Usage
+--------------------------------
+  * Note: These examples assume the application's default time zone is set to UTC.
+    If you have modified the default time zone, directly accessing your DateTime field
+    will render it in _that_ time zone and not UTC.
+
+When working with your instances, Greenwich will convert to the proper time zone when
+you access it.  So if you've previously saved a DateTime like this:
+
+    my_model.start = Time.strptime('2011-07-04 13:00:00 -600 CST')
+
+Then that will result in your model returning the following values (assuming these
+particular columns exist in the database):
+
+    my_model.start_at           # => 2011-07-04 19:00:00 GMT
+    my_model.start_datetime     # => 2011-07-04 19:00:00 GMT
+    my_model.start_time_zone    # => 'Central Standard Time'
+    my_model.time_zone          # => 'Central Standard Time'
+
+Whereas asking Greenwich for the value of `start` will result in:
+
+    my_model.start              # => 2011-07-04 13:00:00 CST
+
+If you then change your time zone:
+
+    my_model.start_time_zone = 'Eastern Standard Time'
+
+Then calling the attributes on your model will result in the following:
+
+    my_model.start_at           # => 2011-07-04 19:00:00 GMT
+    my_model.start_datetime     # => 2011-07-04 19:00:00 GMT
+    my_model.start_time_zone    # => 'Eastern Standard Time'
+    my_model.time_zone          # => 'Eastern Standard Time'
+
+And again, asking Greenwich for the value of `start` will result in:
+
+    my_model.start              # => 2011-07-04 13:00:00 EST
+
+Issues
+------
+
+If you have problems, please create a [Github issue](https://github.com/jfelchner/validates_truthiness/issues).
+
+Credits
+-------
+
+![thekompanee](http://www.thekompanee.com/public_files/kompanee-github-readme-logo.png)
+
+validates_truthiness is maintained by [The Kompanee, Ltd.](http://www.thekompanee.com)
+
+The names and logos for The Kompanee are trademarks of The Kompanee, Ltd.
+
+License
+-------
+
+validates_truthiness is Copyright © 2011 The Kompanee. It is free software, and may be redistributed under the terms specified in the LICENSE file.
+

data/Rakefile

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

data/greenwich.gemspec

@@ -0,0 +1,34 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "greenwich/version"
+
+Gem::Specification.new do |s|
+  s.rubygems_version  = '1.4.2'
+
+  s.name              = "greenwich"
+  s.rubyforge_project = "greenwich"
+
+  s.version           = Greenwich::VERSION
+  s.platform          = Gem::Platform::RUBY
+
+  s.authors           = ["thekompanee", "jfelchner"]
+  s.email             = ["support@thekompanee.com"]
+  s.homepage          = "http://github.com/jfelchner/greenwich"
+
+  s.summary           = %q{Allowing users to select dates with custom time zones since 2011.}
+  s.description       = %q{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?}
+
+  s.rdoc_options      = ["--charset = UTF-8"]
+  s.extra_rdoc_files  = %w[README.md LICENSE]
+
+  #= Manifest =#
+  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"]
+  #= Manifest =#
+
+  s.add_development_dependency('bundler',   '~> 1.0.15')
+  s.add_development_dependency('rspec',     '~> 2.6.0')
+  s.add_development_dependency('yard',      '~> 0.7.1')
+end

data/lib/greenwich.rb

@@ -0,0 +1,5 @@
+require "greenwich/version"
+
+module Greenwich
+  # Your code goes here...
+end

data/lib/greenwich/version.rb

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

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: greenwich
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- thekompanee
+- jfelchner
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-07-03 00:00:00.000000000 -05:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &2153525320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.15
+  type: :development
+  prerelease: false
+  version_requirements: *2153525320
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2153524820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *2153524820
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &2153524360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: *2153524360
+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
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+- LICENSE
+files:
+- .gitignore
+- Gemfile
+- Rakefile
+- greenwich.gemspec
+- lib/greenwich.rb
+- lib/greenwich/version.rb
+- README.md
+- LICENSE
+has_rdoc: true
+homepage: http://github.com/jfelchner/greenwich
+licenses: []
+post_install_message: 
+rdoc_options:
+- --charset = UTF-8
+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: greenwich
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Allowing users to select dates with custom time zones since 2011.
+test_files: []