Formup
Formup is rubygem for creating data model based form class.
Formup use activemodel gem.(>= 3.2.0)
You can get the benefits of ActiveModel. ex) validations, application to form_for etc.
Installation
Add this line to your application's Gemfile:
gem 'formup'
And then execute:
$ bundle
Or install it yourself as:
$ gem install formup
Usage
Include Formup to your class.
class SalesForm
include Formup
# define attributes (sales_id, sales_price, sales_tax)
source :sales, :attributes => [:id, :price, :tax]
# define attributes (customer_id, customer_name, contact)
source :customer, :attributes => [:id, :name], :aliases => { :email => :contact }
attr_accessor :items
# Handle hash parameters that were not processed in initialize method.
def handle_extra_params(params)
self.items = {}
params.each do |k, v|
self.items[v] = params[k.to_s.gsub(/^code/, "count")] if k.to_s.match(/^code/)
end
end
endInitialize with hash parameters.(like ActiveRecord)
# params => { :sales_id => 1, :sales_price => 1000, ... }
form = SalesForm.new(params)Load from hash and data model that have some accessor methods.
form = SalesForm.new
sales = Sales.find(1)
form.load(:sales => sales, :customer => { :id => 1, :name => "John Doe", :email => "john@example.com"})Get parameters for data model by params_for method.
form = SalesForm.new(params)
sales = Sales.new(form.params_for(:sales))
sales.saveContributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request