readymade 0.1.7 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d8b08e5bcf92035a49dbec37847653f0b99743c2f508c96e50b0aba312b3905
-  data.tar.gz: 2ec517133167b7ec909d9bf2e77c0fdb185774017f70f8871586ec0eb942925e
+  metadata.gz: 7626ae0687a31a055b912eaa725f049317bc44c38f18ff51b060f71ac188afba
+  data.tar.gz: 49de3d0d889bf1ab67e1f424f1c9421b47378e2f5ed10ce6c5cb3e261fcc1e92
 SHA512:
-  metadata.gz: c2388b93ffa8fd5bb5fe988546dab3383a70ec36296ca0efe6a34475c2e06514a43ff0b12c61986aaf50d6a03c529076c92d1b802647a310a12b44b966dc27d4
-  data.tar.gz: ec9b42d63e9ba52d2a27fa10ac2ccf572de6c287b14a1f0e9269c7554adb0f10deee2ad0a6fb62a05c5ac7db2854e96abb6ca554774b632bfaa4f037057822b0
+  metadata.gz: 8775ea40ef291da68cbd8e3527bfc5202a29b30a3664b80649070b288d29c92befb6e596ddcc5a81a8b8ef8af32db6f76302576f1a1a405b3fc2121bdbf54fc3
+  data.tar.gz: 8cbcf0794b7ad7597f306cc885479afd61ee1eabb030770d2610f776218e2b005a1b3397e65064bdd00181aab1af8abe91c783575c1b29e54c6ba9296d212de4

data/CHANGELOG.md

@@ -1,6 +1,24 @@
 Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.2.1] - 2022-04-21
+
+### Improvements
+
+* Update collection_response controller helper
+
+## [0.2.0] - 2022-04-13
+
+### Improvements
+
+* Add support for ruby 3.0, 3.1
+
+## [0.1.8] - 2022-03-30
+
+### Improvements
+
+* Improve README.md and form examples
+
 ## [0.1.6] - 2021-12-20
 
 ### Features

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    readymade (0.1.7)
+    readymade (0.2.1)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,7 +1,13 @@
-# Readymade 0.1.7
+# Readymade 0.2.1
 
 This gems contains basic components to follow [ABDI architecture](https://github.com/OrestF/OrestF/blob/master/abdi/ABDI_architecture.md)
 
+### Tested with ruby:
+
+- 3.1
+- 3.0
+- 2.7
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -29,13 +35,35 @@ Inherit your components from:
 
 ### Readymade::Response
 
-```TODO: add```
+```ruby
+response = Readymade::Response.new(:success, my_data: data)
+response.success? # true
+response = Readymade::Response.new(:fail, errors: errors)
+response.success? # false
+response.fail? # true
+response.status # 'fail'
+response.data # { errors: { some: 'errors' } }
+```
 
 ### Readymade::Form
 
-```TODO: add```
+Check more form features examples in `lib/readymade/form.rb`
+```ruby
+class Orders::Forms::Create < Readymade::Form
+  PERMITTED_ATTRIBUTES = %i[email name category country customer]
+  REQUIRED_ATTRIBUTES = %i[email]
+
+  validates :customer, presence: true, if: args[:validate_customer]
+end
 
-#### #form_options
+order_form = Orders::Forms::Create.new(params, order: order, validate_customer: false)
+
+order_form.valid? # true
+
+
+```
+
+#### form_options
 
 ```ruby
 # app/forms/my_form.rb
@@ -57,17 +85,17 @@ end
 # app/controllers/items_controller.rb
 
 def new
-  @form_options = MyForm.form_options(company: current_company)
+  @form = MyForm.form_options(company: current_company)
 end
 ```
 
 ```slim
 / app/views/items/new.html.slim
 
-= f.select :category, collection: @form_options[:categories]
-= f.select :country, collection: @form_options[:countries]
-= f.text_field :email, required: @form_options.required?(:email) # true
-= f.text_field :name, required: @form_options.required?(:name) # false
+= f.select :category, collection: @form[:categories]
+= f.select :country, collection: @form[:countries]
+= f.text_field :email, required: @form.required?(:email) # true
+= f.text_field :name, required: @form.required?(:name) # false
 ```
 
 ### Readymade::InstantForm
@@ -80,11 +108,46 @@ Readymade::InstantForm.new(my_params, permitted: %i[name phone], required: %i[em
 
 ### Readymade::Action
 
-```TODO: add```
+```ruby
+class Orders::Actions::SendNotifications < Readymade::Action
+  def call
+    send_email
+    send_push
+    send_slack
+
+    response(:success, record: record, any_other_data: data)
+  end
+end
+```
+
+```ruby
+response = Orders::Actions::SendNotifications.call(order: order)
+
+response.fail? # false
+response.success? # true
+response.data[:record]
+response.data[:any_other_data]
+```
 
 ### Readymade::Operation
 
-```TODO: add```
+Provides set of help methods like: `build_form`, `form_valid?`, `validation_fail`, `save_record`, etc.
+```ruby
+class Orders::Operations::Create < Readymade::Operation
+  def call
+    build_record
+    build_form
+    return validation_fail unless form_valid?
+
+    assign_attributes
+    return validation_fail unless record_valid?
+
+    save_record
+
+    success(record: record)
+  end
+end
+```
 
 
 ## Development

data/lib/readymade/action.rb

@@ -12,11 +12,10 @@ module Readymade
 
     attr_reader :args, :data
 
-    def initialize(**args)
+    def initialize(args = {})
       raise NonKeywordArgumentsError if args.present? && !args.is_a?(Hash)
 
       @args = @data = args
-
       @args.each do |name, value|
         instance_variable_set("@#{name}", value)
       end

data/lib/readymade/controller/serialization.rb

@@ -25,7 +25,7 @@ module Readymade
 
         render_json(
           {
-            items: serialize_collection(paginate(collection, options), options),
+            (options.delete(:root).presence || :items) => serialize_collection(paginate(collection, options), options),
             count: collection.count
           },
           options[:status] || :ok

data/lib/readymade/form.rb

@@ -147,21 +147,19 @@ module Readymade
 
     # EXAMPLE
     # class Items::Forms::Create::Value < ::Readymade::Form
-    #   PERMITTED_ATTRIBUTES = %i[attr1 attr2].freeze
-    #   REQUIRED_ATTRIBUTES = %i[attr1].freeze
+    #   PERMITTED_ATTRIBUTES = %i[vat_percent price_type item_category].freeze
+    #   REQUIRED_ATTRIBUTES = %i[item_category].freeze
     #
-    #   class Value < ::Readymade::Form::Value
-    #     def to_h
-    #       {
-    #         vat_percent: Item::VAT_OPTIONS,
-    #         price_type: Item.price_types.keys,
-    #         item_category: args[:company].item_categories
-    #       }
-    #     end
+    #   def form_options
+    #     {
+    #       vat_percent: Item::VAT_OPTIONS,
+    #       price_type: Item.price_types.keys,
+    #       item_category: args[:company].item_categories
+    #     }
     #   end
 
-    # @form_options = Items::Forms::Create::Value.new(company: current_company)
-    # f.association :item_category, collection: @form_options[:item_category]
+    # @form = Items::Forms::Create.form_options(company: current_company)
+    # f.association :item_category, collection: @form[:item_category], required: @form.required?(:item_category)
 
     def self.form_options(**args)
       Readymade::Form::FormOptions.new(**args.merge!(form_class: self))
@@ -179,7 +177,7 @@ module Readymade
       end
 
       def to_h
-        raise Readymade::Error.new('define form_options on your form') unless (f = @f_class.new({}, @args)).respond_to?(:form_options)
+        raise Readymade::Error.new('define form_options on your form') unless (f = @f_class.new({}, **@args)).respond_to?(:form_options)
 
         f.form_options
       end

data/lib/readymade/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Readymade
-  VERSION = '0.1.7'
+  VERSION = '0.2.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: readymade
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.2.1
 platform: ruby
 authors:
 - OrestF
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-03-15 00:00:00.000000000 Z
+date: 2022-04-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -102,7 +102,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Set of base classes for ABDI architecture