simple_form_nested_fields 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 968039b20ea8b76c398ebe16d627e5daa039eb4b30955380852f074e12880e02
+  data.tar.gz: c64d8fc0113c9db8788eefc332dae38770d7af4219faffcd2e792470e0ccd6cb
+SHA512:
+  metadata.gz: a31dab975e4bfb5d04aff1c82f1ea62833c3f45ebf86168fe8b797f7b12be7f9437c2e77657448d8cc83717a097470aedf1033393647085a0d3a6e564ead594d
+  data.tar.gz: 6d8df7ccf3068db6904ca33cef7b9161146b97817dad7c1fbfceecf39e124c66f544ca279b66a838f81f0075145b38e6baa21743c3cc4d25ea41ef06c6979496

data/.babelrc

@@ -0,0 +1,3 @@
+{
+  "presets": ["es2015"]
+}

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/test/dummy/tmp/
+/test/dummy/log/*.log
+/node_modules

data/.travis.yml

@@ -0,0 +1,15 @@
+sudo: required
+language: ruby
+rvm:
+  - 2.5.1
+services:
+  - mongodb
+addons:
+  chrome: stable
+  apt:
+    packages:
+      - chromium-chromedriver
+before_install:
+  - gem install bundler -v 1.16.1
+before_script:
+  - ln -s /usr/lib/chromium-browser/chromedriver ~/bin/chromedriver

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# CHANGELOG
+
+## 0.1.0
+
+* initial release

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+source 'https://rails-assets.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,244 @@
+PATH
+  remote: .
+  specs:
+    simple_form_nested_fields (0.1.0)
+      coffee-rails
+      simple_form
+
+GEM
+  remote: https://rubygems.org/
+  remote: https://rails-assets.org/
+  specs:
+    actioncable (5.2.1)
+      actionpack (= 5.2.1)
+      nio4r (~> 2.0)
+      websocket-driver (>= 0.6.1)
+    actionmailer (5.2.1)
+      actionpack (= 5.2.1)
+      actionview (= 5.2.1)
+      activejob (= 5.2.1)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 2.0)
+    actionpack (5.2.1)
+      actionview (= 5.2.1)
+      activesupport (= 5.2.1)
+      rack (~> 2.0)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (5.2.1)
+      activesupport (= 5.2.1)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.3)
+    activejob (5.2.1)
+      activesupport (= 5.2.1)
+      globalid (>= 0.3.6)
+    activemodel (5.2.1)
+      activesupport (= 5.2.1)
+    activerecord (5.2.1)
+      activemodel (= 5.2.1)
+      activesupport (= 5.2.1)
+      arel (>= 9.0)
+    activestorage (5.2.1)
+      actionpack (= 5.2.1)
+      activerecord (= 5.2.1)
+      marcel (~> 0.3.1)
+    activesupport (5.2.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    addressable (2.5.2)
+      public_suffix (>= 2.0.2, < 4.0)
+    ansi (1.5.0)
+    arel (9.0.0)
+    bson (4.3.0)
+    builder (3.2.3)
+    capybara (2.18.0)
+      addressable
+      mini_mime (>= 0.1.3)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      xpath (>= 2.0, < 4.0)
+    capybara-screenshot (1.0.21)
+      capybara (>= 1.0, < 4)
+      launchy
+    childprocess (0.9.0)
+      ffi (~> 1.0, >= 1.0.11)
+    coderay (1.1.2)
+    coffee-rails (4.2.2)
+      coffee-script (>= 2.2.0)
+      railties (>= 4.0.0)
+    coffee-script (2.4.1)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.12.2)
+    concurrent-ruby (1.0.5)
+    crass (1.0.4)
+    database_cleaner (1.7.0)
+    erubi (1.7.1)
+    execjs (2.7.0)
+    ffi (1.9.25)
+    formatador (0.2.5)
+    globalid (0.4.1)
+      activesupport (>= 4.2.0)
+    guard (2.14.2)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (>= 1.0.12, < 2.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-minitest (2.4.6)
+      guard-compat (~> 1.2)
+      minitest (>= 3.0)
+    i18n (1.1.0)
+      concurrent-ruby (~> 1.0)
+    jquery-rails (4.3.3)
+      rails-dom-testing (>= 1, < 3)
+      railties (>= 4.2.0)
+      thor (>= 0.14, < 2.0)
+    launchy (2.4.3)
+      addressable (~> 2.3)
+    listen (3.1.5)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+      ruby_dep (~> 1.2)
+    loofah (2.2.2)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    lumberjack (1.0.13)
+    mail (2.7.0)
+      mini_mime (>= 0.1.1)
+    marcel (0.3.3)
+      mimemagic (~> 0.3.2)
+    method_source (0.9.0)
+    mimemagic (0.3.2)
+    mini_mime (1.0.1)
+    mini_portile2 (2.3.0)
+    minitest (5.11.3)
+    minitest-around (0.4.1)
+      minitest (~> 5.0)
+    minitest-capybara (0.8.2)
+      capybara (~> 2.2)
+      minitest (~> 5.0)
+      rake
+    minitest-metadata (0.6.0)
+      minitest (>= 4.7, < 6.0)
+    minitest-rails (3.0.0)
+      minitest (~> 5.8)
+      railties (~> 5.0)
+    minitest-rails-capybara (3.0.1)
+      capybara (~> 2.7)
+      minitest-capybara (~> 0.8)
+      minitest-metadata (~> 0.6)
+      minitest-rails (~> 3.0)
+    minitest-reporters (1.3.4)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    mongo (2.6.2)
+      bson (>= 4.3.0, < 5.0.0)
+    mongoid (7.0.2)
+      activemodel (>= 5.1, < 6.0.0)
+      mongo (>= 2.5.1, < 3.0.0)
+    nenv (0.3.0)
+    nio4r (2.3.1)
+    nokogiri (1.8.4)
+      mini_portile2 (~> 2.3.0)
+    notiffany (0.1.1)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    public_suffix (3.0.3)
+    rack (2.0.5)
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    rails (5.2.1)
+      actioncable (= 5.2.1)
+      actionmailer (= 5.2.1)
+      actionpack (= 5.2.1)
+      actionview (= 5.2.1)
+      activejob (= 5.2.1)
+      activemodel (= 5.2.1)
+      activerecord (= 5.2.1)
+      activestorage (= 5.2.1)
+      activesupport (= 5.2.1)
+      bundler (>= 1.3.0)
+      railties (= 5.2.1)
+      sprockets-rails (>= 2.0.0)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.0.4)
+      loofah (~> 2.2, >= 2.2.2)
+    railties (5.2.1)
+      actionpack (= 5.2.1)
+      activesupport (= 5.2.1)
+      method_source
+      rake (>= 0.8.7)
+      thor (>= 0.19.0, < 2.0)
+    rake (10.5.0)
+    rb-fsevent (0.10.3)
+    rb-inotify (0.9.10)
+      ffi (>= 0.5.0, < 2)
+    ruby-progressbar (1.10.0)
+    ruby_dep (1.5.0)
+    rubyzip (1.2.2)
+    selenium-webdriver (3.14.0)
+      childprocess (~> 0.5)
+      rubyzip (~> 1.2)
+    shellany (0.0.1)
+    simple_form (4.0.1)
+      actionpack (>= 5.0)
+      activemodel (>= 5.0)
+    sprockets (3.7.2)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    sprockets-rails (3.2.1)
+      actionpack (>= 4.0)
+      activesupport (>= 4.0)
+      sprockets (>= 3.0.0)
+    thor (0.20.0)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
+    websocket-driver (0.7.0)
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.3)
+    xpath (3.1.0)
+      nokogiri (~> 1.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.12)
+  capybara (~> 2.1)
+  capybara-screenshot
+  database_cleaner
+  guard
+  guard-minitest
+  jquery-rails
+  minitest (~> 5.0)
+  minitest-around
+  minitest-metadata
+  minitest-rails-capybara
+  minitest-reporters
+  mongoid
+  rails
+  rake (~> 10.0)
+  selenium-webdriver
+  simple_form_nested_fields!
+
+BUNDLED WITH
+   1.16.1

data/Guardfile

@@ -0,0 +1,8 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :minitest do
+  watch(%r{^lib/(.+)\.rb$})                               { |m| "test/#{m[1]}_test.rb" }
+  watch(%r{^test/.+_test\.rb$})
+  watch(%r{^test/test_helper\.rb$})                       { 'test' }
+end

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Tomáš Celizna
+
+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/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 asgerb
+
+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,190 @@
+# Simple Form Nested Fields
+
+[![Build Status](https://travis-ci.org/tomasc/simple_form_nested_fields.svg)](https://travis-ci.org/tomasc/simple_form_nested_fields) [![Gem Version](https://badge.fury.io/rb/simple_form_nested_fields.svg)](http://badge.fury.io/rb/simple_form_nested_fields) [![Coverage Status](https://img.shields.io/coveralls/tomasc/simple_form_nested_fields.svg)](https://coveralls.io/r/tomasc/simple_form_nested_fields)
+
+Nested fields helper for [`simple_form`](https://github.com/plataformatec/simple_form).
+
+Makes it easier to handle forms with referenced/embedded models and attributes;
+e.g. a document with embedded texts, a project with referenced tasks, or an
+invoice with line items.
+
+Works with standard Rails forms and SimpleForm.
+
+## Dependencies
+
+This gem depends on jQuery.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'simple_form_nested_fields'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install simple_form_nested_fields
+
+If using sprockets, require the javascript in your `application.js`:
+
+```js
+//= require simple_form_nested_fields
+```
+
+and initialise the plugin like this:
+
+```js
+$(document).ready(
+  function() {
+    $(".simple_form_nested_fields").SimpleFormNestedFields()
+  }
+)
+```
+
+## Usage
+
+Suppose you have a model `MyDoc`, which embeds `texts`:
+
+```ruby
+# app/models/my_doc.rb
+class MyDoc
+  include Mongoid::Document
+  embeds_many :texts, class_name: 'Text'
+  accepts_nested_attributes_for :texts, allow_destroy: true
+end
+
+# app/models/text.rb
+class Text
+  include Mongoid::Document
+  field :body, type: String
+  embedded_in :my_doc, class_name: 'MyDoc'
+end
+```
+
+You can then use the `nested_fields_for` helper to work with the texts in your
+form:
+
+```slim
+= simple_form_for @my_doc do |f|
+  = f.nested_fields_for :texts
+  = f.submit
+```
+
+This will render the `texts/_fields` partial, in which you can use the `fields`
+helper:
+
+```slim
+// app/views/my_docs/texts/_fields.html.slim
+= fields.input :body
+```
+
+### Sortable
+
+Making the nested fields sortable is straight forward.
+
+Using our `MyDoc` and `texts` example, the models would look like this (note the
+`order` on the `embeds_many` and the `position` field on the `Text`):
+
+```ruby
+# app/models/my_doc.rb
+class MyDoc
+  include Mongoid::Document
+  embeds_many :texts, class_name: 'Text', order: :position.asc
+  accepts_nested_attributes_for :texts, allow_destroy: true
+end
+
+# app/models/text.rb
+class Text
+  include Mongoid::Document
+  field :body, type: String
+  field :position, type: Integer
+  embedded_in :my_doc, class_name: 'MyDoc'
+end
+```
+
+Then in your `MyDoc` form simply pass the `sortable` option to the
+`nested_fields_for` helper (note that in order to pass the option parameter, you
+have to pass the second parameter: the collection/record object):
+
+```slim
+= simple_form_for @my_doc do |f|
+  = f.nested_fields_for :texts, @my_doc.texts, sortable: true
+  = f.submit
+```
+
+And in your `Text` fields partial add the position input:
+
+```slim
+// app/views/my_docs/texts/_fields.html.slim
+= fields.input :position, as: :hidden
+= fields.input :body
+```
+
+### Configuration
+
+#### Custom partial path
+
+You can override the default `_fields` partial lookup path as follows:
+
+```slim
+= simple_form_for @my_doc do |f|
+  = f.nested_fields_for :texts, nil, partial: 'my/own/path/to/fields'
+  = f.submit
+```
+
+#### I18n
+
+You can change the text on the add and remove links by overriding the locale
+file:
+
+```YAML
+# config/locales/simple_form_nested_fields.en.yml
+en:
+  simple_form_nested_fields:
+    links:
+      add: 'Add %{model_name}'
+      remove: 'Remove'
+```
+
+### Styling
+
+The gem has no default styling, but leaves that up to you.
+For reference, here's an example markup:
+
+```html
+<div class="simple_form_nested_fields simple_form_nested_fields__texts">
+  <div class="simple_form_nested_fields__title">Texts</div>
+  <div class="simple_form_nested_fields__items">
+    <div class="simple_form_nested_fields__item simple_form_nested_fields__item__new">
+      <!-- input fields here -->
+      <a class="simple_form_nested_fields__link simple_form_nested_fields__link__remove">Remove</a>
+    </div>
+  </div>
+  <div class="simple_form_nested_fields__links">
+    <a class="simple_form_nested_fields__link simple_form_nested_fields__link__add">Add Title</a>
+  </div>
+</div>
+```
+
+## Todo
+
+* Sortable field name should be configurable (`position` by default)
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/tomasc/simple_form_nested_fields. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).