jquids 0.2.1

data/.gitignore

@@ -0,0 +1,2 @@
+*.gem
+*.swp

data/.rspec

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

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (C) 2011 by Tim Harper and Nicholas LaMuro
+
+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,213 @@
+Jquids
+======
+
+This is a rewrite of Tim Harper's "Calendar Date Select" gem
+(https://github.com/timcharper/calendar_date_select) using the jQuery UI date
+picker.  This project is still in development and still far from working.
+
+The projects intent is to simulate the ease of use of the original while:
+
+- Updating the code to work with Rails 3
+- Using the hosted jQuery UI infastructure to avoid local dependencies
+
+
+Jquids stands for *JQ*uery *UI* *D*ate *S*elect
+
+
+Usage
+-----
+
+Add the following some where in your page (preferablly in the head of your
+layout file):
+
+    <%= jquids_includes %>
+
+Change a field to so it uses the `jquids_tag`:
+
+    <%= jquids_tag "some_date" %>
+
+and you should be good to go!
+
+
+Customization
+-------------
+
+CalendarDateSelect allow for the use of many different formats and css styles,
+and Jquids was made to allow for that same kind of flexibility, with
+out all of the weight of an full library of javascript and css files in your
+public folder.
+
+
+### jQeury Version
+
+To specify a different version of jQuery, just include :jQuery => "X.X.X" to
+your 'jquids_includes' method:
+
+    <%= jquids_includes :jQuery => "1.6.0" %>
+
+A list of supported versions numbers can be found at the bottom of the page.
+
+Because it is entirely possible that you are already using jQuery in your
+application, the option is given to you to not include jQuery using
+Jquids.  To do that, just add :jQuery => :none to your
+'jquids_includes' method:
+
+    <%= jquids_includes :jQuery => :none %>
+
+and now jQuery will not be included into your plugin.
+
+
+### jQuery UI Version
+
+Just like you can specify a specific version of jQuery, you can also specify a
+version of jQuery UI that you would prefer to use:
+
+    <%= jquids_includes :jQueryUI => "1.8.0" %>
+
+A list of supported version numbers can be found at the bottom of the page.
+
+You are also able tell the Jquids not to load jQuery UI in the same way
+that you did with jQuery:
+
+    <%= jquids_includes :jQueryUI => :none %>
+
+You may also use `nil` or `false`.
+
+
+### Custom Style
+
+To change the style, just add `:style => :new_style` to the
+`jquids_includes` declaration:
+
+    <%= jquids_includes :style => :vader %>
+
+And the new style will be applied.  All styles come from the Google CDN
+(http://code.google.com/apis/libraries/devguide.html), so they are not hosted
+in your application.  If you wish to theme roll your own style
+(http://jqueryui.com/themeroller/), just set `:style` to `:none`, `nil`, or
+`false`, and include your style sheet in your project.
+
+All styles that are available via the Google CDN for jQueryUI can be found
+below.
+
+
+### Custom Format
+
+To set the format the same way that was done with CalendarDateSelect, just set
+the Jquids format variable using the `format=` function somewhere in
+your code:
+
+    <% Jquids.format= :american %>
+
+or you can set it in `jquids_includes` method by setting the
+`:format` variable in the options hash:
+
+    <%= jquids_includes :format => :american %>
+
+All the formats used mimic what was used in the original CalendarDateSelect
+gem.  The formats available are listed below.
+
+
+### Customizing the jQuery UI Datepicker
+
+The jQuery datepicker has many options that you can implement through
+Jquids via the `:datepicker_options` hash.  To add an option to a
+single datepicker element, simply add the hash as an argument to
+`jquids_tag` call:
+
+    <%= jquids_tag "some_date", nil, :datepicker_options => {:showButtonPanel => true} %>
+
+and now the datepicker will use the jQueryUI's button panel at the bottom of
+the datepicker for that instance.  But if you have multiple instances that all
+should have the `showButtonPanel` equal to true, add the `:datepicker_options`
+to the `jquids_includes`:
+
+    <%= jquids_includes :datepicker_options => {:showButtonPanel => true} %>
+
+and the change will be applied to all instances of the datepicker.  You can
+overide that change by setting the setting to false on the desired
+`jquids_tag` instances.
+
+A full list of all of the jQueryUI functions can be found here:
+http://jqueryui.com/demos/datepicker/#options
+
+
+jQuery Versions
+---------------
+"1.2.3, 1.2.6, 1.3.0, 1.3.1, 1.3.2, 1.4.0, 1.4.1, 1.4.2, 1.4.3, 1.4.4, 1.5.0,
+1.5.1, 1.5.2, 1.6.0, 1.6.1"
+
+
+jQuery UI Versions
+------------------
+"1.5.2, 1.5.3, 1.6.0, 1.7.0, 1.7.1, 1.7.2, 1.7.3, 1.8.0, 1.8.1, 1.8.2, 1.8.4,
+1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.8.10, 1.8.11, 1.8.12, 1.8.13"
+
+
+Styles
+------
+
+The default style is `:base`.  The following can be implemented via the
+`jquids_includes` function:
+
+* `:base`
+* `:black_tie`
+* `:blitzer`
+* `:cupertino`
+* `:dark_hive`
+* `:dot_luv`
+* `:eggplant`
+* `:excite_bike`
+* `:flick`
+* `:hot_sneaks`
+* `:humanity`
+* `:le_frog`
+* `:mint_choc`
+* `:overcast`
+* `:pepper_grinder`
+* `:redmond`
+* `:smoothness`
+* `:south_street`
+* `:start`
+* `:sunny`
+* `:swanky_purse`
+* `:trontastic`
+* `:ui_darkness`
+* `:ui_lightness`
+* `:vader`
+
+
+Formats
+-------
+
+The default format is `:natural`.  Other formats include:
+
+* `:natural` = "%B %d, %Y"
+* `:hyphen_ampm` = "%Y-%m-%d"
+* `:iso_date` = "%Y-%m-%d"
+* `:finnish` = "%d.%m.%Y"
+* `:danish` = "%d/%m/%Y"
+* `:american` = "%m/%d/%Y"
+* `:euro_24hr` = "%d %B %Y"
+* `:euro_24hr_ymd` = "%Y.%m.%d"
+* `:italian` = "%d/%m/%Y"
+* `:db` = "%Y-%m-%d"
+
+The only two formats currently with time
+in am-pm is `:natural`, `:hyphen_ampm`, and `:american`.
+
+
+TODO
+----
+
+- Allow for setting the format via the `jquids_includes` method and
+  the ability to set it on a case by case basis (implemented, but has a bug)
+- Map the option settings for CalendarDateSelect to Jquids
+- Get callbacks working
+- Get it to work in rails 2 and 3 (with tests)
+- Integrate with formtastic
+
+
+Contribute/Suggestions
+----------------------
+Suggestions and contributions to the project are welcome.

data/Rakefile

@@ -0,0 +1,44 @@
+require "rubygems"
+#require "rspec/core/rake_task"
+require "rspec/core/rake_task" if Gem.source_index.find_name('rspec').map {|x| x.version}.first.version.to_i >= 2
+require "spec/rake/spectask" if Gem.source_index.find_name('rspec').map {|x| x.version}.first.version.to_i < 2
+
+desc 'Default: run spec.'
+task :default => :spec
+
+if Gem.source_index.find_name('rspec').map {|x| x.version}.first.version.to_i >= 2
+  desc "Run specs"
+  RSpec::Core::RakeTask.new do |t|
+    t.pattern = "./spec/**/*_spec.rb" # not needed, it' a default.
+    # Put spec opts in a file named .rspec in root
+  end
+elsif Gem.source_index.find_name('rspec').map {|x| x.version}.first.version.to_i < 2
+  desc "Run specs"
+  Spec::Rake::SpecTask.new do |t|
+    t.spec_files = "./spec/**/*_spec.rb"
+    # Put spec opts in a file named spec.opts in your spec folder
+  end
+end
+
+gemspec = eval(File.read(Dir["*.gemspec"].first))
+
+desc "Validate the gemspec"
+task :gemspec do
+  puts "Validating the gem..."
+  gemspec.validate
+end
+ 
+desc "Build gem locally"
+task :build => :gemspec do
+  puts "Building the gem..."
+  system "gem build #{gemspec.name}.gemspec"
+  FileUtils.mkdir_p "pkg"
+  FileUtils.mv "#{gemspec.name}-#{gemspec.version}.gem", "pkg"
+end
+ 
+desc "Install gem locally"
+task :install => :build do
+  puts "Installing..."
+  system "gem install pkg/#{gemspec.name}-#{gemspec.version}"
+end
+

data/init.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + "/lib/jquids.rb"

data/jquids.gemspec

@@ -0,0 +1,17 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "jquids/constants/version"
+
+Gem::Specification.new do |s|
+  s.name = "jquids"
+  s.version = Jquids::VERSION
+  s.platform = Gem::Platform::RUBY
+  s.summary = "Integrating the jQueryUI date picker for Rails"
+  s.description = "Integrating the jQueryUI date picker for Rails"
+  s.authors = "Nick LaMuro"
+  s.email = "nicklamuro@gmail.com"
+  s.homepage = "https://github.com/NickLaMuro/jquids"
+
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {spec}/*`.split("\n")
+  s.require_paths = ["lib"]
+end

data/lib/jquids.rb

@@ -0,0 +1,9 @@
+require "jquids/jquids.rb"
+require "jquids/includes_helper.rb"
+require "jquids/form_helpers.rb"
+require "jquids/errors/not_a_known_format.rb"
+require "jquids/errors/not_a_known_style.rb"
+
+ActionView::Helpers::FormHelper.send(:include, Jquids::FormHelpers)
+ActionView::Base.send(:include, Jquids::FormHelpers)
+ActionView::Base.send(:include, Jquids::IncludesHelper)

data/lib/jquids/constants/formats.rb

@@ -0,0 +1,74 @@
+module Jquids
+  FORMATS = {
+    :natural => {
+      :date => "%B %d, %Y",
+      :time => " %I:%M %p",
+      :js_date => "MM dd, yy",
+      :tr_js_time => "hh:mm TT",
+      :ampm => true
+    },
+    :hyphen_ampm => {
+      :date => "%Y-%m-%d",
+      :time => " %I:%M %p",
+      :js_date => "yy-mm-dd",
+      :tr_js_time => "hh:mm TT",
+      :ampm => true
+    },
+    :iso_date => {
+      :date => "%Y-%m-%d",
+      :time => " %H:%M",
+      :js_date => "yy-mm-dd",
+      :tr_js_time => "hh:mm",
+      :ampm => false
+    },
+    :finnish => {
+      :date => "%d.%m.%Y",
+      :time => " %H:%M",
+      :js_date => "dd.mm.yy",
+      :tr_js_time => "hh:mm",
+      :ampm => false
+    },
+    :danish => {
+      :date => "%d/%m/%Y",
+      :time => " %H:%M",
+      :js_date => "dd/mm/yy",
+      :tr_js_time => "hh:mm",
+      :ampm => false
+    },
+    :american => {
+      :date => "%m/%d/%Y",
+      :time => " %I:%M %p",
+      :js_date => "mm/dd/yy",
+      :tr_js_time => "hh:mm TT",
+      :ampm => true
+    },
+    :euro_24hr => {
+      :date => "%d %B %Y",
+      :time => " %H:%M",
+      :js_date => "dd MM yy",
+      :tr_js_time => "hh:mm",
+      :ampm => false
+    },
+    :euro_24hr_ymd => {
+      :date => "%Y.%m.%d",
+      :time => " %H:%M",
+      :js_date => "yy.mm.dd",
+      :tr_js_time => "hh:mm",
+      :ampm => false
+    },
+    :italian => {
+      :date => "%d/%m/%Y",
+      :time => " %H:%M",
+      :js_date => "dd/mm/yy",
+      :tr_js_time => "hh:mm",
+      :ampm => false
+    },
+    :db => {
+      :date => "%Y-%m-%d",
+      :time => " %H:%M",
+      :js_date => "yy-mm-dd",
+      :tr_js_time => "hh:mm",
+      :ampm => false
+    }
+  }
+end

data/lib/jquids/constants/jq_versions.rb

@@ -0,0 +1,3 @@
+module Jquids
+  JQVersions = %w{1.2.3 1.2.6 1.3.0 1.3.1 1.3.2 1.4.0 1.4.1 1.4.2 1.4.3 1.4.4 1.5.0 1.5.1 1.5.2 1.6.0 1.6.1}
+end

data/lib/jquids/constants/styles.rb

@@ -0,0 +1,29 @@
+module Jquids
+  STYLES = {
+    :base => "base",
+    :black_tie => "black-tie",
+    :blitzer => "blitzer",
+    :cupertino => "cupertino",
+    :dark_hive => "dark-hive",
+    :dot_luv => "dot-luv",
+    :eggplant => "eggplant",
+    :excite_bike => "excite-bike",
+    :flick => "flick",
+    :hot_sneaks => "hot-sneaks",
+    :humanity => "humanity",
+    :le_frog => "le-frog",
+    :mint_choc => "mint-choc",
+    :overcast => "overcast",
+    :pepper_grinder => "pepper-grinder",
+    :redmond => "redmond",
+    :smoothness => "smoothness",
+    :south_street => "south-street",
+    :start => "start",
+    :sunny => "sunny",
+    :swanky_purse => "swanky-purse",
+    :trontastic => "trontastic",
+    :ui_darkness => "ui-darkness",
+    :ui_lightness => "ui-lightness",
+    :vader => "vader"
+  }
+end

data/lib/jquids/constants/timepicker_tags.rb

@@ -0,0 +1,3 @@
+module Jquids
+  TimepickerTags = %w{v0.8 v0.9 v0.9.1 v0.9.2 v0.9.3 v0.9.4 v0.9.5}
+end

data/lib/jquids/constants/ui_versions.rb

@@ -0,0 +1,3 @@
+module Jquids
+  UIVersions = %w{1.5.2 1.5.3 1.6.0 1.7.0 1.7.1 1.7.2 1.7.3 1.8.0 1.8.1 1.8.2 1.8.4 1.8.5 1.8.6 1.8.7 1.8.8 1.8.9 1.8.10 1.8.11 1.8.12 1.8.13}
+end

data/lib/jquids/constants/version.rb

@@ -0,0 +1,3 @@
+module Jquids
+  VERSION = "0.2.1"
+end

data/lib/jquids/errors/not_a_known_format.rb

@@ -0,0 +1,8 @@
+class Jquids::NotAKnownFormat < StandardError
+
+  # Not sure how to define a default message, but currently that is not needed
+  #def self.message
+    #"Jquids: Unrecognized format specification"
+  #end
+
+end