jquery-ui-rails 0.0.2 → 0.1.0

data/License.txt

@@ -0,0 +1,3 @@
+jQuery UI as well as this gem are dual-licensed under the MIT license (see
+jquery-ui/MIT-LICENSE.txt) and the GPL version 2 (see
+jquery-ui/GPL-LICENSE.txt).

data/README.md

@@ -14,31 +14,53 @@ In your Gemfile, add:
       gem 'jquery-ui-rails'
     end
 
-Then pick JavaScript and CSS modules to require, as listed bwlow.
+## Require Everything
 
-Dependencies between JavaScript modules and between CSS modules are
-automatically resolved, and the images required by the theme are available as
-assets. However, you may still need to include the corresponding CSS for any
-JavaScript.
+To require all jQuery UI modules, add the following to your application.js:
 
-### Example
+```javascript
+//= require jquery.ui.all
+```
 
-Let's say you want to add a [date picker](http://jqueryui.com/themeroller/). In
-your application.js, simply require its JavaScript module:
+Also add the jQuery UI CSS to your application.css:
 
-    //= require jquery.ui.datepicker
+```css
+/*
+ *= require jquery.ui.all
+ */
+```
 
-In your application.css, require the corresponding CSS module:
+All images required by jQuery UI are automatically served through the asset
+pipeline, so you are good to go! For example, this code will add a
+[datepicker](http://jqueryui.com/demos/datepicker/):
+
+```javascript
+$(function() {
+  $('.datepicker').datepicker();
+});
+```
 
-    /*
-     *= require jquery.ui.datepicker
-     */
+## Require Specific Modules
 
-And you are good to go:
+The jQuery UI code weighs 51KB (minified + gzipped) and takes a while to
+execute, so for production apps it's recommended to only include the modules
+that your application actually uses. Dependencies are automatically resolved.
+Simply pick one or more modules from the asset list below.
 
-    $(function() {
-      $('.datepicker').datepicker();
-    });
+For example, if you only need the datepicker module, add this to your
+application.js:
+
+```javascript
+//= require jquery.ui.datepicker
+```
+
+In your application.css, require the corresponding CSS module:
+
+```css
+/*
+ *= require jquery.ui.datepicker
+ */
+```
 
 ## JavaScript Assets
 
@@ -46,152 +68,168 @@ Pick and choose from the following modules:
 
 ### UI Core
 
-    //= require jquery.ui.core
-    //= require jquery.ui.widget
-    //= require jquery.ui.mouse
-    //= require jquery.ui.position
+```javascript
+//= require jquery.ui.core
+//= require jquery.ui.widget
+//= require jquery.ui.mouse
+//= require jquery.ui.position
+```
 
 You usually do not need to require these directly, as they are pulled in by the
 other JavaScript modules as needed.
 
 ### Interactions
 
-    //= require jquery.ui.draggable
-    //= require jquery.ui.droppable
-    //= require jquery.ui.resizable
-    //= require jquery.ui.selectable
-    //= require jquery.ui.sortable
+```javascript
+//= require jquery.ui.draggable
+//= require jquery.ui.droppable
+//= require jquery.ui.resizable
+//= require jquery.ui.selectable
+//= require jquery.ui.sortable
+```
 
 For `jquery.ui.resizable` and `jquery.ui.selectable`, remember to `require`
 their matching CSS files in your application.css as well.
 
 ### Widgets
 
-    //= require jquery.ui.accordion
-    //= require jquery.ui.autocomplete
-    //= require jquery.ui.button
-    //= require jquery.ui.dialog
-    //= require jquery.ui.slider
-    //= require jquery.ui.tabs
-    //= require jquery.ui.datepicker
-    //= require jquery.ui.progressbar
+```javascript
+//= require jquery.ui.accordion
+//= require jquery.ui.autocomplete
+//= require jquery.ui.button
+//= require jquery.ui.dialog
+//= require jquery.ui.slider
+//= require jquery.ui.tabs
+//= require jquery.ui.datepicker
+//= require jquery.ui.progressbar
+```
 
 For all of these, remember to `require` their matching CSS files in your
 application.css as well.
 
-Datepicker has optional i18n modules non-US locales, named
+Datepicker has optional i18n modules for non-US locales, named
 `jquery.ui.datepicker-xx[-YY]`
 ([list](https://github.com/jquery/jquery-ui/tree/1.8.16/ui/i18n)), for example:
 
-    //= require jquery.ui.datepicker-pt-BR
+```javascript
+//= require jquery.ui.datepicker-pt-BR
+```
 
 ### Effects
 
-    //= require jquery.effects.core
-    //= require jquery.effects.blind
-    //= require jquery.effects.bounce
-    //= require jquery.effects.clip
-    //= require jquery.effects.drop
-    //= require jquery.effects.explode
-    //= require jquery.effects.fade
-    //= require jquery.effects.fold
-    //= require jquery.effects.highlight
-    //= require jquery.effects.pulsate
-    //= require jquery.effects.scale
-    //= require jquery.effects.shake
-    //= require jquery.effects.slide
-    //= require jquery.effects.transfer
-
-### Everything
-
-When you are feeling lazy, you can also require all modules (UI and effects) at
-once:
-
-    //= require jquery.ui.all
-
-This is only recommended for development, as it slows down the load and
-execution time. You should generally only require those modules that are
-actually used by your application.
+```javascript
+//= require jquery.effects.core
+//= require jquery.effects.blind
+//= require jquery.effects.bounce
+//= require jquery.effects.clip
+//= require jquery.effects.drop
+//= require jquery.effects.explode
+//= require jquery.effects.fade
+//= require jquery.effects.fold
+//= require jquery.effects.highlight
+//= require jquery.effects.pulsate
+//= require jquery.effects.scale
+//= require jquery.effects.shake
+//= require jquery.effects.slide
+//= require jquery.effects.transfer
+```
 
 ## Stylesheet Assets
 
 ### UI Core
 
-    /*
-     *= require jquery.ui.core
-     *= require jquery.ui.theme
-     */
+```css
+/*
+ *= require jquery.ui.core
+ *= require jquery.ui.theme
+ */
+```
 
 You might want to require these if you do not use any of the following modules,
-but still want jQuery UI's basic theming CSS.
+but still want jQuery UI's basic theming CSS. Otherwise they are automatically
+pulled in as dependencies.
 
 ### Interactions
 
-    /*
-     *= require jquery.ui.resizable
-     *= require jquery.ui.selectable
-     */
+```css
+/*
+ *= require jquery.ui.resizable
+ *= require jquery.ui.selectable
+ */
+```
 
 ### Widgets
 
-    /*
-     *= require jquery.ui.accordion
-     *= require jquery.ui.autocomplete
-     *= require jquery.ui.button
-     *= require jquery.ui.dialog
-     *= require jquery.ui.slider
-     *= require jquery.ui.tabs
-     *= require jquery.ui.datepicker
-     *= require jquery.ui.progressbar
-     */
+```css
+/*
+ *= require jquery.ui.accordion
+ *= require jquery.ui.autocomplete
+ *= require jquery.ui.button
+ *= require jquery.ui.dialog
+ *= require jquery.ui.slider
+ *= require jquery.ui.tabs
+ *= require jquery.ui.datepicker
+ *= require jquery.ui.progressbar
+ */
+```
 
-### Everything
+## Contributing
 
-As with the JavaScript, you can also require all CSS modules at once:
+### Bug Reports
 
-    /*
-     *= require jquery.ui.all
-     */
+For bugs in jQuery UI itself, head to the [jQuery UI Development
+Center](http://jqueryui.com/development).
 
-## Images
+For bugs in this gem distribution, use the GitHub issue tracker. In particular,
+the asset dependencies between files are set up by this gem, not by the jQuery
+UI upstream. If you find that a JavaScript or CSS file does not pull in its
+dependencies correctly, please open an issue!
 
-The images for the default theme are available as assets in the `jquery-ui`
-directory. You typically do not need to do anything about them, as they are
-automatically picked up by the `jquery.ui.theme` CSS file.
+### Setup
 
-## Hacking and Contributing
+```bash
+git clone git://github.com/joliss/jquery-ui-rails.git
+cd jquery-ui-rails
+git submodule update --init
+bundle install
+bundle exec rake
+```
 
-    git clone git://github.com/joliss/jquery-ui-rails.git
-    cd jquery-ui-rails
-    git submodule update --init
-    bundle install
-    bundle exec rake # rebuild
+Most of the code lives in the `Rakefile`. Pull requests are more than welcome!
 
-To hack jQuery UI:
+### Hacking jQuery UI
 
-    cd jquery-ui
-    git checkout master # or 1-8-stable
-    ... hack-hack-hack ...
-    cd ..
-    bundle exec rake # rebuild assets based on your changes
+The jquery-ui-rails repository has a git submodule containing the official
+[jquery-ui repo](https://github.com/jquery/jquery-ui). This way it's easy to
+hack the jQuery UI code:
+
+```bash
+cd jquery-ui
+git checkout master  # or 1-8-stable
+... hack-hack-hack ...
+bundle exec rake  # rebuild assets based on your changes
+```
 
 Assuming your app's Gemfile points at your jquery-ui-rails checkout (`gem
 'jquery-ui-rails', :path => '~/path/to/jquery-ui-rails'`), all you need to do
 now is refresh your browser, and your changes to jQuery UI are live in your
-application.
+Rails application.
 
-As a smoke test, a `testapp` application is available in the repository, which
-displays a checkmark and a date picker to make sure the assets load correctly:
+You can send pull requests to the
+[jquery-ui](https://github.com/jquery/jquery-ui) GitHub project straight out of
+your submodule. See also their
+[Getting Involved](http://wiki.jqueryui.com/w/page/35263114/Getting-Involved)
+guide.
 
-    cd testapp
-    bundle install
-    rails server
+### Testing
 
-Now load [http://localhost:3000/](http://localhost:3000/).
+As a smoke test, a `testapp` application is available in the repository, which
+displays a check mark and a datepicker to make sure the assets load correctly:
 
-## License
+```bash
+cd testapp
+bundle install
+rails server
+```
 
-jQuery UI is dual-licensed under the MIT License (jquery-ui/MIT-LICENSE.txt)
-and the GPL version 2 (jquery-ui/GPL-LICENSE.txt). This gem is dual-licensed
-under the MIT License (MIT-LICENSE.txt) and the GPL version 2 (GPL-LICENSE.txt)
-as well.
+Now point your browser at [http://localhost:3000/](http://localhost:3000/).

data/Rakefile

@@ -29,7 +29,6 @@ end
 desc "Remove the vendor directory"
 task :clean do
   FileUtils.rm_rf 'vendor'
-  # We could do rm(Dir.glob('vendor/**/*.*') - `git ls-files vendor`.split("\n"))
 end
 
 desc "Generate the JavaScript assets"
@@ -70,9 +69,9 @@ task :stylesheets do
     unless basename =~ /\.(all|base|core|theme)\./
       dependencies = DEPENDENCY_HASH[basename.sub(/\Ajquery\./, '').sub(/\.css/, '.js')]
       if dependencies.nil?
-	puts "Warning: No matching JavaScript dependencies found for #{basename}"
+        puts "Warning: No matching JavaScript dependencies found for #{basename}"
       else
-	extra_dependencies << 'jquery.ui.theme' if dependencies.include? 'theme'
+        extra_dependencies << 'jquery.ui.theme' if dependencies.include? 'theme'
       end
     end
     extra_dependencies.reverse.each do |dep|

data/lib/jquery/ui/rails/version.rb

@@ -1,7 +1,7 @@
 module Jquery
   module Ui
     module Rails
-      VERSION = "0.0.2"
+      VERSION = "0.1.0"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jquery-ui-rails
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-17 00:00:00.000000000 Z
+date: 2012-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
-  requirement: &17710540 !ruby/object:Gem::Requirement
+  requirement: &20629080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 3.1.0
   type: :runtime
   prerelease: false
-  version_requirements: *17710540
+  version_requirements: *20629080
 - !ruby/object:Gem::Dependency
   name: jquery-rails
-  requirement: &17710140 !ruby/object:Gem::Requirement
+  requirement: &20628700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *17710140
+  version_requirements: *20628700
 - !ruby/object:Gem::Dependency
   name: execjs
-  requirement: &17709580 !ruby/object:Gem::Requirement
+  requirement: &20628160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,8 +43,8 @@ dependencies:
         version: '1.0'
   type: :development
   prerelease: false
-  version_requirements: *17709580
-description: jQuery UI JavaScript, CSS, and image files packaged for the Rails 3.1+
+  version_requirements: *20628160
+description: jQuery UI's JavaScript, CSS, and image files packaged for the Rails 3.1+
   asset pipeline
 email:
 - joliss42@gmail.com
@@ -53,74 +53,15 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitmodules
-- GPL-LICENSE.txt
 - Gemfile
-- MIT-LICENSE.txt
+- License.txt
 - README.md
 - Rakefile
 - dependencies.js
-- jquery-ui-rails.gemspec
 - lib/jquery-ui-rails.rb
 - lib/jquery/ui/rails.rb
 - lib/jquery/ui/rails/engine.rb
 - lib/jquery/ui/rails/version.rb
-- testapp/Gemfile
-- testapp/Gemfile.lock
-- testapp/README.rdoc
-- testapp/Rakefile
-- testapp/app/assets/images/rails.png
-- testapp/app/assets/javascripts/application.js
-- testapp/app/assets/javascripts/home.js.coffee
-- testapp/app/assets/javascripts/jquery_ui_test.js
-- testapp/app/assets/stylesheets/application.css
-- testapp/app/assets/stylesheets/home.css.scss
-- testapp/app/assets/stylesheets/jquery_ui_test.css
-- testapp/app/controllers/application_controller.rb
-- testapp/app/controllers/home_controller.rb
-- testapp/app/helpers/application_helper.rb
-- testapp/app/helpers/home_helper.rb
-- testapp/app/mailers/.gitkeep
-- testapp/app/models/.gitkeep
-- testapp/app/views/home/index.html.erb
-- testapp/app/views/layouts/application.html.erb
-- testapp/config.ru
-- testapp/config/application.rb
-- testapp/config/boot.rb
-- testapp/config/database.yml
-- testapp/config/environment.rb
-- testapp/config/environments/development.rb
-- testapp/config/environments/production.rb
-- testapp/config/environments/test.rb
-- testapp/config/initializers/backtrace_silencers.rb
-- testapp/config/initializers/inflections.rb
-- testapp/config/initializers/mime_types.rb
-- testapp/config/initializers/secret_token.rb
-- testapp/config/initializers/session_store.rb
-- testapp/config/initializers/wrap_parameters.rb
-- testapp/config/locales/en.yml
-- testapp/config/routes.rb
-- testapp/db/seeds.rb
-- testapp/doc/README_FOR_APP
-- testapp/lib/assets/.gitkeep
-- testapp/lib/tasks/.gitkeep
-- testapp/log/.gitkeep
-- testapp/public/404.html
-- testapp/public/422.html
-- testapp/public/500.html
-- testapp/public/favicon.ico
-- testapp/public/robots.txt
-- testapp/script/rails
-- testapp/test/fixtures/.gitkeep
-- testapp/test/functional/.gitkeep
-- testapp/test/functional/home_controller_test.rb
-- testapp/test/integration/.gitkeep
-- testapp/test/performance/browsing_test.rb
-- testapp/test/test_helper.rb
-- testapp/test/unit/.gitkeep
-- testapp/test/unit/helpers/home_helper_test.rb
-- testapp/vendor/assets/javascripts/.gitkeep
-- testapp/vendor/assets/stylesheets/.gitkeep
-- testapp/vendor/plugins/.gitkeep
 - vendor/assets/javascripts/jquery.ui.core.js
 - vendor/assets/javascripts/jquery.ui.datepicker-et.js
 - vendor/assets/javascripts/jquery.ui.datepicker-uk.js