durl-rails

dURL! For Rails!

This gem provides:

• dURL

See VERSIONS.md to see which versions of durl-rails bundle which versions of dURL.

patch version bump = updates to durl-rails, and patch-level updates to dURL
minor version bump = minor-level updates to dURL
major version bump = major-level updates to dURL and updates to rails which may be backwards-incompatible

Gemfile

gem "durl-rails"

And run bundle install. The rest of the installation depends on whether the asset pipeline is being used.

The dURL files will be added to the asset pipeline and available for you to use. add these lines to app/assets/javascripts/application.js:

//= require durl

This gem adds a single generator: durl:install. Running the generator will copy dURL to the public/javascripts directory.

This gem will also hook into the Rails configuration process, adding dURL to the javascript files included by the javascript_include_tag(:defaults) call. While this gem contains the minified and un-minified versions of dURL, only the minified versions will be included in the :defaults when Rails is run in production or test mode (un-minified versions will be included when Rails is run in development mode).

To invoke the generator, run:

rails generate durl:install

You're done!

If the NPM DURL library changes, run rake update_durl and commit. It will pull from source the latest version of DURL and will also bump the version of this gem.

This gem's structure and technique for wrapping a JS library into a rails friendly package is based entirely on jquery-rails. Many thanks are due to all of the jquery-rails contributors.

Copyright Tyler Kasten, released under the MIT License.