da-js 0.0.1

data/.gitignore

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

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## Version 0.0.1
+
+* Initial Version

data/Gemfile

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

data/README.md

@@ -0,0 +1,33 @@
+# da-js – Collection of small, useful JavaScripts
+This are some JavaScripts we use in most of our projects. So packaged them into a gem.
+
+Okay, right now it’s only one, small JavaScript. But just be patient … 
+ 
+## Installation
+da-js is meant to be used with Ruby on Rails 3.1 or newer. It's based on [jQuery](http://jquery.com), so be sure you are using [jquery-rails](https://github.com/rails/jquery-rails), too (__jQuery version 1.7.1 or newer is required__).
+
+To install it:
+
+* Add the gem to your `Gemfile`:
+      
+        gem "da-js"
+    
+* Require the library in your `application.js` (after requiring jQuery):
+    
+        require "da-js"
+    
+## Documentation
+For documentation please refer to the individual files in [`lib/assets/javascripts/da-js`](https://github.com/die-antwort/da-js/tree/master/lib/da-js).
+
+## Development
+Use the Rack application in `features/support/testapp`:
+
+    rackup features/support/testapp/config.ru
+    
+Any template file in `features/support/testapp/views` can be accessed by its basename:
+    
+    open http:://localhost:9292/form_change_tracker
+    
+Run the tests with
+
+    rake test

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+
+require 'cucumber'
+require 'cucumber/rake/task'
+
+Cucumber::Rake::Task.new(:test) do |t|
+  t.cucumber_opts = "features --format progress"
+end

data/da-js.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "da-js/version"
+
+Gem::Specification.new do |s|
+  s.name        = "da-js"
+  s.version     = Da::Js::VERSION
+  s.authors     = ["Stefan Daschek"]
+  s.email       = ["stefan@die-antwort.eu"]
+  s.homepage    = "https://github.com/die-antwort/da-js"
+  s.summary     = "Mixed jQuery extensions"
+  s.description = "Some jQuery extensions we tend to use in almost all our projects."
+
+  s.rubyforge_project = "da-js"
+
+  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"]
+
+  s.add_dependency "railties", ">= 3.1.0"
+  s.add_dependency "sprockets", "~> 2.0"
+  
+  s.add_development_dependency "cucumber", ">= 1.1.4"
+  s.add_development_dependency "rspec-expectations", ">= 2.7.0"
+  s.add_development_dependency "sinatra"
+  s.add_development_dependency "sinatra-contrib"
+  s.add_development_dependency "capybara", ">= 1.1.2"
+  s.add_development_dependency "capybara-webkit", ">= 0.8.0"
+  s.add_development_dependency "launchy"
+end

data/features/change_tracker.feature

@@ -0,0 +1,119 @@
+@javascript
+Feature: Change tracker for forms
+  There are two special cases:
+   - A select has always a selected option. We use the first option (with empty value) as "empty".
+   - All radiobuttons can initially be unselected, but going back to this state is impossible. So, in the "empty form" scenario, we skip the radiobutton in second part (when we test "resetting" the form elements)
+  
+  Scenario Outline: An empty form 
+    Given an empty <Form>
+    Then no <Element> should be marked as changed
+     
+    When I enter some text in the textfield
+    Then the textfield's <Element> should be marked as changed
+    
+    When I enter some text in the textarea
+    Then the textarea's <Element> should be marked as changed
+    
+    When I check the checkbox
+    Then the checkbox's <Element> should be marked as changed
+    
+    When I select the first option
+    Then the select's <Element> should be marked as changed
+    
+    # Now for resetting everything (except radiobuttons, see feature description)
+    When I clear the textfield
+    Then the textfield's <Element> should no longer be marked as changed
+    
+    When I clear the textarea
+    Then the textarea's <Element> should no longer be marked as changed
+    
+    When I uncheck the checkbox
+    Then the checkbox's <Element> should no longer be marked as changed
+
+    When I select the empty option
+    Then the select's <Element> should no longer be marked as changed
+    
+    Examples:
+      | Form          | Element                |
+      | simple_form   | form element and label |
+      | scaffold_form | field container        |
+
+  
+  Scenario: Radiobuttons in an empty simple form
+    Given an empty simple_form
+    When I choose the first radiobutton
+    Then the first radiobutton's form element and label should be marked as changed
+    But the second radiobutton's form element and label should not be marked as changed
+    And the third radiobutton's form element and label should not be marked as changed
+
+     
+  Scenario: Radiobuttons in an empty scaffold form
+    Given an empty scaffold_form
+    When I choose the first radiobutton
+    Then the first radiobutton's field container should be marked as changed
+  
+ 
+  Scenario Outline: A prefilled form 
+    Given a prefilled <Form>
+    Then no <Element> should be marked as changed
+     
+    When I change the textfield's content
+    Then the textfield's <Element> should be marked as changed
+    When I clear the textfield
+    Then the textfield's <Element> should be marked as changed
+    
+    When I change the textarea's content
+    Then the textarea's <Element> should be marked as changed
+    When I clear the textarea
+    Then the textarea's <Element> should be marked as changed
+    
+    When I uncheck the checkbox
+    Then the checkbox's <Element> should be marked as changed
+    
+    When I select the second option
+    Then the select's <Element> should be marked as changed
+    
+    # Now reset everything again
+    When I reset the textfield to its initial value
+    Then the textfield's <Element> should no longer be marked as changed
+    
+    When I reset the textarea to its initial value
+    Then the textarea's <Element> should no longer be marked as changed
+    
+    When I check the checkbox
+    Then the checkbox's <Element> should no longer be marked as changed
+
+    When I select the first option
+    Then the select's <Element> should no longer be marked as changed
+
+    And no <Element> should be marked as changed
+
+    Examples:
+      | Form          | Element                |
+      | simple_form   | form element and label |
+      | scaffold_form | field container        |
+
+
+  Scenario: Radiobuttons in an prefilled simple form
+    Given an prefilled simple_form
+    Then no form element and label should be marked as changed
+  
+    When I choose the second radiobutton
+    Then the second radiobutton's form element and label should be marked as changed
+    And the first radiobutton's form element and label should be marked as changed
+    But the third radiobutton's form element and label should not be marked as changed
+    
+    When I choose the first radiobutton
+    Then no form element and label should be marked as changed    
+
+     
+  Scenario: Radiobuttons in an prefilled scaffold form
+    Given an prefilled scaffold_form
+    Then no form element and label should be marked as changed
+    
+    When I choose the second radiobutton
+    Then the second radiobutton's field container should be marked as changed
+
+    When I choose the first radiobutton
+    Then no form element and label should be marked as changed
+  

data/features/step_definitions/change_tracker_steps.rb

@@ -0,0 +1,128 @@
+def find_element_and_label(element)
+  id = "#{@form}_#{element}"
+  [find("##{@form} ##{id}"), find("##{@form} label[for='#{id}']")]
+end
+
+def find_container(element)
+  find(:xpath, "//form[@id='#{@form}']//div[contains(@class, 'field')][*[@id='#{@form}_#{element}']]")
+end
+
+Given /^an? (empty|prefilled) (\w+)$/ do |type, form|
+  visit "/form_change_tracker"
+  @form = form.dup # Without #dup Cucumber prints the step incorrectly
+  @form << "_prefilled" if type == "prefilled"
+end
+
+
+When /^I enter some text in the (\w+)$/ do |field|
+  within "##{@form}" do
+    fill_in field, :with => "foobar"
+  end
+end
+
+When /^I change the (\w+)'s content$/ do |field|
+  within "##{@form}" do
+    fill_in field, :with => find_field(field).value + " plus some new text"
+  end
+end
+
+When /^I clear the (\w+)$/ do |field|
+  within "##{@form}" do
+    fill_in field, :with => ""
+  end
+end
+
+When /^I reset the (\w+) to its initial value$/ do |field|
+  within "##{@form}" do
+    fill_in field, :with => "text"
+  end
+end
+
+When /^I (check|uncheck) the checkbox$/ do |action|
+  within "##{@form}" do
+    if action == "check"
+      check "checkbox"
+    else
+      uncheck "checkbox"
+    end
+  end
+end
+
+When /^I choose the (first|second) radiobutton$/ do |which|
+  button = (which == "first" ? "1" : (which == "second" ? "2" : "3"))
+  within "##{@form}" do
+    choose button
+  end
+end
+
+When /^I select the (blank|first|second) option$/ do |which|
+  option = (which == "blank" ? "" : (which == "first" ? "option 1" : "option 2"))
+  within "##{@form}" do
+    select option
+  end
+end
+
+When /^I select the empty option$/ do
+  within "##{@form}" do
+    select ""
+  end
+end
+
+
+Then /^no form element and label should be marked as changed$/ do
+  within "##{@form}" do
+    all("input,textarea,select,label").each do |element|
+      element["class"].should_not include("changed")
+    end
+  end
+end
+
+Then /^no field container should be marked as changed$/ do
+  within "##{@form}" do
+    all(".field").each do |element|
+      element["class"].should_not include("changed")
+    end
+  end
+end
+
+Then /^the (first|second|third) radiobutton's form element and label should( not| no longer)? be marked as changed$/ do |which, no_longer|
+  button = (which == "first" ? "1" : (which == "second" ? "2" : "3"))
+  element, label = find_element_and_label("radiobutton_#{button}")
+  if no_longer
+    element["class"].should_not include("changed")
+    label["class"].should_not include("changed")
+  else
+    element["class"].should include("changed")
+    label["class"].should include("changed")
+  end
+end
+
+Then /^the (first|second|third) radiobutton's field container should( not| no longer)? be marked as changed$/ do |which, no_longer|
+  button = (which == "first" ? "1" : (which == "second" ? "2" : "3"))
+  container = find_container("radiobutton_#{button}")
+  if no_longer
+    container["class"].should_not include("changed")
+  else
+    container["class"].should include("changed")
+  end
+end
+
+Then /^the (\w+)'s form element and label should( no longer)? be marked as changed$/ do |element, no_longer|
+  element, label = find_element_and_label(element)
+  if no_longer
+    element["class"].should_not include("changed")
+    label["class"].should_not include("changed")
+  else
+    element["class"].should include("changed")
+    label["class"].should include("changed")
+  end
+end
+
+Then /^the (\w+)'s field container should( no longer)? be marked as changed$/ do |element, no_longer|
+  container = find_container(element)
+  if no_longer
+    container["class"].should_not include("changed")
+  else
+    container["class"].should include("changed")
+  end
+end

data/features/support/env.rb

@@ -0,0 +1,7 @@
+require "rails/engine"
+require "capybara/cucumber"
+require "capybara-webkit"
+require "rack"
+
+Capybara.javascript_driver = :webkit
+Capybara.app, _ = Rack::Builder.parse_file(File.dirname(__FILE__) + "/testapp/config.ru")

data/features/support/testapp/config.ru

@@ -0,0 +1,12 @@
+require 'sprockets'
+require File.dirname(__FILE__) + "/testapp"
+
+map '/assets' do
+  environment = Sprockets::Environment.new
+  environment.append_path File.dirname(__FILE__) + '/../../../lib/assets'
+  run environment
+end
+
+map '/' do
+  run Sinatra::Application
+end

data/features/support/testapp/testapp.rb

@@ -0,0 +1,21 @@
+require "sinatra"
+require "sinatra/reloader" if development?
+
+set :app_file, __FILE__
+
+before do
+  @jquery_version = params[:jquery] || "1.7.1"
+end
+
+get "/vendor/:file" do |file|
+  send_file settings.root + "/vendor/#{file}"
+end
+
+# Don't spam console/log with errors caused by a missing favicon
+get "/favicon.ico" do
+  404
+end
+
+get "/:view" do |view|
+  erb view.to_sym
+end