cocoon 1.0.0

data/.gitignore

@@ -0,0 +1,7 @@
+.bundle/
+log/*.log
+pkg/
+spec/dummy/db/*.sqlite3
+spec/dummy/log/*.log
+spec/dummy/tmp/
+.rvmrc

data/Gemfile

@@ -0,0 +1,19 @@
+source "http://rubygems.org"
+
+gem "rails", "3.0.3"
+#gem "capybara", ">= 0.4.0"
+gem "sqlite3-ruby", :require => "sqlite3"
+
+gem "json_pure"
+
+group :development, :test do
+  gem "jeweler"
+  gem "rspec-rails", ">= 2.0.0.beta"
+  gem "rspec",       ">= 2.0.0.rc"
+  gem "actionpack",  ">=3.0.0"
+  gem "simplecov", :require => false
+end
+
+# To use debugger (ruby-debug for Ruby 1.8.7+, ruby-debug19 for Ruby 1.9.2+)
+# gem 'ruby-debug'
+# gem 'ruby-debug19'

data/Gemfile.lock

@@ -0,0 +1,107 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    abstract (1.0.0)
+    actionmailer (3.0.3)
+      actionpack (= 3.0.3)
+      mail (~> 2.2.9)
+    actionpack (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+      builder (~> 2.1.2)
+      erubis (~> 2.6.6)
+      i18n (~> 0.4)
+      rack (~> 1.2.1)
+      rack-mount (~> 0.6.13)
+      rack-test (~> 0.5.6)
+      tzinfo (~> 0.3.23)
+    activemodel (3.0.3)
+      activesupport (= 3.0.3)
+      builder (~> 2.1.2)
+      i18n (~> 0.4)
+    activerecord (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+      arel (~> 2.0.2)
+      tzinfo (~> 0.3.23)
+    activeresource (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+    activesupport (3.0.3)
+    arel (2.0.7)
+    builder (2.1.2)
+    diff-lcs (1.1.2)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    gemcutter (0.6.1)
+    git (1.2.5)
+    i18n (0.5.0)
+    jeweler (1.4.0)
+      gemcutter (>= 0.1.0)
+      git (>= 1.2.5)
+      rubyforge (>= 2.0.0)
+    json_pure (1.4.6)
+    mail (2.2.15)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.16)
+    polyglot (0.3.1)
+    rack (1.2.1)
+    rack-mount (0.6.13)
+      rack (>= 1.0.0)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rails (3.0.3)
+      actionmailer (= 3.0.3)
+      actionpack (= 3.0.3)
+      activerecord (= 3.0.3)
+      activeresource (= 3.0.3)
+      activesupport (= 3.0.3)
+      bundler (~> 1.0)
+      railties (= 3.0.3)
+    railties (3.0.3)
+      actionpack (= 3.0.3)
+      activesupport (= 3.0.3)
+      rake (>= 0.8.7)
+      thor (~> 0.14.4)
+    rake (0.8.7)
+    rspec (2.4.0)
+      rspec-core (~> 2.4.0)
+      rspec-expectations (~> 2.4.0)
+      rspec-mocks (~> 2.4.0)
+    rspec-core (2.4.0)
+    rspec-expectations (2.4.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.4.0)
+    rspec-rails (2.4.1)
+      actionpack (~> 3.0)
+      activesupport (~> 3.0)
+      railties (~> 3.0)
+      rspec (~> 2.4.0)
+    rubyforge (2.0.4)
+      json_pure (>= 1.1.7)
+    simplecov (0.3.7)
+      simplecov-html (>= 0.3.7)
+    simplecov-html (0.3.9)
+    sqlite3 (1.3.3)
+    sqlite3-ruby (1.3.3)
+      sqlite3 (>= 1.3.3)
+    thor (0.14.6)
+    treetop (1.4.9)
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.24)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  actionpack (>= 3.0.0)
+  jeweler
+  json_pure
+  rails (= 3.0.3)
+  rspec (>= 2.0.0.rc)
+  rspec-rails (>= 2.0.0.beta)
+  simplecov
+  sqlite3-ruby

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 YOURNAME
+
+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.markdown

@@ -0,0 +1,150 @@
+# cocoon
+
+cocoon is a Rails3 gem to allow easier handling of nested forms.
+
+Nested forms are forms that handle nested models and attributes in one form.
+For example a project with its tasks, an invoice with its ordered items.
+
+It is formbuilder-agnostic, so it works with standard Rails, or Formtastic or simple_form.
+
+## Prerequisites
+
+This gem uses jQuery, it is most useful to use this gem in a rails3
+project where you are already using jQuery.
+
+Furthermore i would advice you to use either formtastic or simple_form.
+
+I have a sample project where I demonstrate the use of cocoon with formtastic.
+
+## Installation
+
+Inside your `Gemfile` add the following:
+
+    gem "cocoon"
+
+Run the installation task:
+
+    rails g cocoon:install
+
+This will install the needed javascript file.
+Inside your `application.html.haml` you will need to add below the default javascripts:
+
+    = javascript_include_tag :cocoon
+
+or using erb, you write
+
+    <%= javascript_include_tag :cocoon %>
+
+That is all you need to do to start using it!
+
+## Usage
+
+Suppose you have a model `Project`:
+
+    rails g scaffold Project name:string description:string
+
+and a project has many `tasks`:
+
+    rails g model Task description:string done:boolean project_id:integer
+
+Edit the models to code the relation:
+
+    class Project < ActiveRecord::Base
+      has_many :tasks
+      accepts_nested_attributes_for :tasks
+    end
+
+    class Task < ActiveRecord::Base
+      belongs_to :project
+    end
+
+What we want to achieve is to get a form where we can add and remove the tasks dynamically.
+What we need for this, is that the fields for a new/existing `task` are defined in a partial
+view called `_task_fields.html`.
+
+We will show the sample usage with the different possible form-builders.
+
+### Using formtastic
+
+Inside our `projects/_form` partial we then write:
+
+    - f.inputs do
+      = f.input :name
+      = f.input :description
+      %h3 Tasks
+      #tasks
+        = f.semantic_fields_for :tasks do |task|
+          = render 'task_fields', :f => task
+        .links
+          = link_to_add_association 'add task', f, :tasks
+      -f.buttons do
+        = f.submit 'Save'
+
+and inside the `_task_fields` partial we write:
+
+    .nested-fields
+      = f.inputs do
+        = f.input :description
+        = f.input :done, :as => :boolean
+        = link_to_remove_association "remove task", f
+
+That is all there is to it!
+
+There is an example project on github implementing it called [formtastic-cocoon-demo](https://github.com/nathanvda/formtastic-cocoon-demo).
+
+### Using simple_form
+
+There is only line that needs to change, instead of writing `semantic_fields_for` you write `simple_fields_for`.
+
+I will provide a full example (and a sample project) later.
+
+### Using standard rails forms
+
+I provide a full example (and a sample project) later.
+
+## How it works
+
+I define two helper functions:
+
+### link_to_add_association
+
+This function will add a link to your markup that will, when clicked, dynamically add a new partial form for the given association.
+This should be placed below the `semantic_fields_for`.
+
+It takes three parameters:
+
+- name: the text to show in the link
+- f: referring to the containing formtastic form-object
+- association: the name of the association (plural) of which a new instance needs to be added (symbol or string).
+
+### link_to_remove_association
+
+This function will add a link to your markup that will, when clicked, dynamically remove the surrounding partial form.
+This should be placed inside the partial `_<association-object-singular>_fields`.
+
+### Partial
+
+The partial should be named `_<association-object_singular>_fields`, and should start with a div of class `.nested-fields`.
+
+There is no limit to the amount of nesting, though.
+
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+
+## Todo
+
+* complete the sample projects for simple_form and normal rails forms
+* complete the test-coverage
+
+## Copyright
+
+Copyright (c) 2010 Nathan Van der Auwera. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,42 @@
+# encoding: UTF-8
+require 'rubygems'
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rake'
+require 'rake/rdoctask'
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Cocoon'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "cocoon"
+    gem.summary = %Q{gem that enables easier nested forms with standard forms, formtastic and simple-form}
+    gem.description = %Q{Unobtrusive nested forms handling, using jQuery. Use this and discover cocoon-heaven.}
+    gem.email = "nathan@dixis.com"
+    gem.homepage = "http://github.com/nathanvda/cocoon"
+    gem.authors = ["Nathan Van der Auwera"]
+    gem.add_development_dependency "rspec", ">= 2.0.0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/cocoon.gemspec

@@ -0,0 +1,104 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{cocoon}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Nathan Van der Auwera"]
+  s.date = %q{2011-02-09}
+  s.description = %q{Unobtrusive nested forms handling, using jQuery. Use this and discover cocoon-heaven.}
+  s.email = %q{nathan@dixis.com}
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    ".gitignore",
+     "Gemfile",
+     "Gemfile.lock",
+     "MIT-LICENSE",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "cocoon.gemspec",
+     "lib/cocoon.rb",
+     "lib/cocoon/view_helpers.rb",
+     "lib/generators/cocoon/install/install_generator.rb",
+     "lib/generators/cocoon/install/templates/cocoon.js",
+     "spec/cocoon_spec.rb",
+     "spec/dummy/Rakefile",
+     "spec/dummy/app/controllers/application_controller.rb",
+     "spec/dummy/app/helpers/application_helper.rb",
+     "spec/dummy/app/views/layouts/application.html.erb",
+     "spec/dummy/config.ru",
+     "spec/dummy/config/application.rb",
+     "spec/dummy/config/boot.rb",
+     "spec/dummy/config/database.yml",
+     "spec/dummy/config/environment.rb",
+     "spec/dummy/config/environments/development.rb",
+     "spec/dummy/config/environments/production.rb",
+     "spec/dummy/config/environments/test.rb",
+     "spec/dummy/config/initializers/backtrace_silencers.rb",
+     "spec/dummy/config/initializers/inflections.rb",
+     "spec/dummy/config/initializers/mime_types.rb",
+     "spec/dummy/config/initializers/secret_token.rb",
+     "spec/dummy/config/initializers/session_store.rb",
+     "spec/dummy/config/locales/en.yml",
+     "spec/dummy/config/routes.rb",
+     "spec/dummy/public/404.html",
+     "spec/dummy/public/422.html",
+     "spec/dummy/public/500.html",
+     "spec/dummy/public/favicon.ico",
+     "spec/dummy/public/javascripts/application.js",
+     "spec/dummy/public/javascripts/controls.js",
+     "spec/dummy/public/javascripts/dragdrop.js",
+     "spec/dummy/public/javascripts/effects.js",
+     "spec/dummy/public/javascripts/prototype.js",
+     "spec/dummy/public/javascripts/rails.js",
+     "spec/dummy/public/stylesheets/.gitkeep",
+     "spec/dummy/script/rails",
+     "spec/integration/navigation_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/nathanvda/cocoon}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{gem that enables easier nested forms with standard forms, formtastic and simple-form}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/dummy/app/controllers/application_controller.rb",
+     "spec/dummy/app/helpers/application_helper.rb",
+     "spec/dummy/config/environment.rb",
+     "spec/dummy/config/initializers/session_store.rb",
+     "spec/dummy/config/initializers/mime_types.rb",
+     "spec/dummy/config/initializers/secret_token.rb",
+     "spec/dummy/config/initializers/backtrace_silencers.rb",
+     "spec/dummy/config/initializers/inflections.rb",
+     "spec/dummy/config/environments/production.rb",
+     "spec/dummy/config/environments/development.rb",
+     "spec/dummy/config/environments/test.rb",
+     "spec/dummy/config/application.rb",
+     "spec/dummy/config/routes.rb",
+     "spec/dummy/config/boot.rb",
+     "spec/cocoon_spec.rb",
+     "spec/integration/navigation_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 2.0.0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 2.0.0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 2.0.0"])
+  end
+end
+