superform 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e755c08731146b7a40c49b9eeaee5b267b56476764ce97fdb68ae8392e5cad0a
-  data.tar.gz: b369765812de40bf81c672ee7f131e4bc8c0a4c234baf210096a41c175f02505
+  metadata.gz: 764fb4731b8ae1977a1e05ce0410302e5f29f3c008c4e0326f9b3f852118cb37
+  data.tar.gz: 6d7887d4b7b3bbf2af8ebfe7e675a155061e4982231d3f52caefd7a5e4c4c85d
 SHA512:
-  metadata.gz: 014cdef2d3639b063ab13f6d757f68c2eb4b14d3f5c89b51301deae77302c3e6ad11a38c21cd974a2fc4ae22d5f4db57d6b698ff1042ac495aaa13c6bccdaff1
-  data.tar.gz: ad6fd81bc9e597d14b63e2915b0c9ba820da4fa71b7db2f129db25ebee8ded0bc836e2353f1799d8565db689f77a0e2dccc73c9a875336a0dedcf5548b8bf169
+  metadata.gz: edb3acf775edcaacb269b0aff7200d6bfd22d2c5701eb7dd0c96149bbc515acf33b77f586809ac574520a4330c1ed1acbe304e8c54d60a2b219e28b72179321b
+  data.tar.gz: e2b69ed000da6eeddeb3a47f664abfe052bbd85ae0e5649d23131b134d5d68acc9032fd4660260207540724c5fa10b85d6c6b4609484849e7c480a9fbd90bae1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    superform (0.2.0)
+    superform (0.4.0)
       phlex-rails (~> 1.0)
 
 GEM

data/README.md

@@ -10,10 +10,9 @@ Superform aims to be the best way to build forms in Rails applications. Here's w
 
 It's a complete rewrite of Rails form's internals that's inspired by Reactive component design patterns.
 
-## Installation
+[![Maintainability](https://api.codeclimate.com/v1/badges/0e4dfe2a1ece26e3a59e/maintainability)](https://codeclimate.com/github/rubymonolith/superform/maintainability) [![Ruby](https://github.com/rubymonolith/superform/actions/workflows/main.yml/badge.svg)](https://github.com/rubymonolith/superform/actions/workflows/main.yml)
 
-> **Note**
-> This doesn't actually work yet. There is working source code at https://github.com/rubymonolith/demo/tree/main/app/views/superform that's being extracted into a gem. This repo and README exist to validate some ideas before the gem is finalized and published.
+## Installation
 
 Add to the Rails application's Gemfile by executing:
 
@@ -45,7 +44,7 @@ Then render it in your templates. Here's what it looks like from an Erb file.
 
 ```erb
 <h1>New post</h1>
-<%= render Posts::Form.new model: @post %>
+<%= render Posts::Form.new @post %>
 ```
 
 ## Customization
@@ -102,12 +101,12 @@ end
 Then render it from Erb.
 
 ```erb
-<%= render Users::Form.new model: @user %>
+<%= render Users::Form.new @user %>
 ```
 
 Much better!
 
-### Extending Superforms
+## Extending Superforms
 
 The best part? If you have forms with a completely different look and feel, you can extend the forms just like you would a Ruby class:
 
@@ -143,58 +142,39 @@ end
 
 Since Superforms are just Ruby objects, you can organize them however you want. You can keep your view component classes embedded in your Superform file if you prefer for everythign to be in one place, keep the forms in the `app/views/forms/*.rb` folder and the components in `app/views/forms/**/*_component.rb`, use Ruby's `include` and `extend` features to modify different form classes, or put them in a gem and share them with an entire organization or open source community. It's just Ruby code!
 
-### Automatic strong parameters
-
-> **Note**
-> THese docs are a work in progress. Strong params do work, but not as documented below. Stay tuned for updates.
+## Automatic strong parameters
 
-Guess what? Superform also permits form fields for you in your controller, like this:
+Guess what? Superform eliminates then need for Strong Parameters in Rails by assigning the values of the `params` hash _through_ your form via the `assign` method. Here's what it looks like.
 
 ```ruby
-class UserController < ApplicationController
-  # Your actions
-
-  private
-
-  def permitted_params
-    @form.permit params
-  end
-end
-```
-
-To do that though you need to move the form as an inline class into your controller or `app/views` folder, which is pretty easy:
+class PostsController < ApplicationController
+  include Superform::Rails::StrongParameters
 
-```ruby
-class UsersController < ApplicationController
-  # You could also put this in `./app/views/users/form.rb`
-  class Form < ApplicationForm
-    render field(:email).input(type: :email)
-    render field(:name).input
+  def create
+    @post = assign params.require(:post), to: Posts::Form.new(Post.new)
 
-    button(type: :submit) { "Sign up" }
+    if @post.save
+      # Success path
+    else
+      # Error path
+    end
   end
 
-  before_action :assign_form
-
-  # Your actions
+  def update
+    @post = Post.find(params[:id])
 
-  private
-
-  def assign_form
-    @form = Form.new(model: @user)
-  end
+    assign params.require(:post), to: Posts::Form.new(@post)
 
-  def permitted_params
-    @form.permit params
+    if @post.save
+      # Success path
+    else
+      # Error path
+    end
   end
 end
 ```
 
-Then render it from your Erb in less lines, like this:
-
-```
-<%= render @form %>
-```
+How does it work? An instance of the form is created, then the hash is assigned to it. If the params include data outside of what a form accepts, it will be ignored.
 
 ## Comparisons
 

data/lib/superform/rails.rb

@@ -100,6 +100,17 @@ module Superform
       end
     end
 
+    module StrongParameters
+      protected
+        # Assigns params to the form and returns the model.
+        def assign(params, to:)
+          form = to
+          # TODO: Figure out how to render this in a way that doesn't concat a string; just throw everything away.
+          render_to_string form
+          form.assign params
+          form.model
+        end
+    end
 
     module Components
       class FieldComponent < ApplicationComponent

data/lib/superform/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Superform
-  VERSION = "0.2.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: superform
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Brad Gessler
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-07-21 00:00:00.000000000 Z
+date: 2023-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: phlex-rails