readymade 0.2.0 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf49169463a122cc9e591dbf0bfa5933c9cac537368da20cc4917b29751658cc
-  data.tar.gz: 77a1e8ada0ef9dcbf71e646ba50dbfadf88b5d2ea7ab5fc5a0a4facd555748f1
+  metadata.gz: 1a6e8e90fddf55567acfe262c31551b786d880250075f4cd9c5c651cc4838dfe
+  data.tar.gz: e2349c3664e83acbeb0321d822ae80ddab1ad3a8ec8f97377cc0b2a2117ede68
 SHA512:
-  metadata.gz: 9d1d70fabd566948f6f0993aed6a4446a1259810a53e826809fe752cccfa08cd9654619bbae7316c6a427db23815edc3703c56f727c53808f91f8b0326fc19fa
-  data.tar.gz: 84aa64e32f1e6465a24734947777507884b6227d2d3e6054b24781f01e609c8a4a7eb02fcc6c59837d8138947f0f6318f6b74e4576d7b37068a3f75351a65273
+  metadata.gz: e71191a5f142db70281225f3593f26b3f1e063c5a700ee029db55ca99486ed5e734490da0bd9ed360abb0544f8d4d567949c10f8baef33653a6497934dc99320
+  data.tar.gz: e1c077924ee5fa51a9e2e2ce9f7e520fcf75dda30c3a1400afc938154366abb587b8a0fda092d4dfb283d576a66b90ea34ee7823d21e4a8c880fd09f08c898ef

data/CHANGELOG.md

@@ -1,6 +1,24 @@
 Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.2.4] - 2022-05-12
+
+### Fixes
+
+* Fix ApiAttachable empty attachments for non hash assignement
+
+## [0.2.3] - 2022-05-03
+
+### Features
+
+* Add `Readymade::Model::ApiAttachable` - add base64 format to your ActiveStorage
+
+## [0.2.1] - 2022-04-21
+
+### Improvements
+
+* Update collection_response controller helper
+
 ## [0.2.0] - 2022-04-13
 
 ### Improvements

data/Gemfile.lock

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

data/README.md

@@ -1,12 +1,14 @@
-# Readymade 0.1.8
+# Readymade
+
+[![Gem Version](https://badge.fury.io/rb/readymade.png)](https://badge.fury.io/rb/readymade)
 
 This gems contains basic components to follow [ABDI architecture](https://github.com/OrestF/OrestF/blob/master/abdi/ABDI_architecture.md)
 
 ### Tested with ruby:
 
-- 2.7
-- 3.0
 - 3.1
+- 3.0
+- 2.7
 
 ## Installation
 
@@ -38,7 +40,7 @@ Inherit your components from:
 ```ruby
 response = Readymade::Response.new(:success, my_data: data)
 response.success? # true
-response =Readymade::Response.new(:fail, errors: errors)
+response = Readymade::Response.new(:fail, errors: errors)
 response.success? # false
 response.fail? # true
 response.status # 'fail'
@@ -149,6 +151,49 @@ class Orders::Operations::Create < Readymade::Operation
 end
 ```
 
+### Readymade::Controller::Serialization
+
+```ruby
+class MyController < ApplicationController
+  include Readymade::Controller::Serialization
+end
+```
+
+Serialization helpers for controllers.
+Dependencies that must be installed on your own:
+- [blueprinter](https://rubygems.org/gems/blueprinter/)
+- [pagy](https://rubygems.org/gems/pagy)
+- [api-pagination](https://rubygems.org/gems/api-pagination)
+
+### Readymade::Model::ApiAttachable
+
+Add base64 attachments format for your models
+
+```ruby
+class User < ApplicationRecord
+  has_one_attached :avatar
+  has_many_attached :images
+  include Readymade::Model::ApiAttachable
+  # must be included after has_one_attached, has_many_attached declaration
+  # api_file = {
+  #   base64: 'iVBORw0KGgoAAA....',
+  #   filename: 'my_avatar.png'
+  # }
+  # record.avatar = api_file 🎉
+end
+```
+
+copy [spec/support/api_attachable.rb](./spec/support/api_attachable.rb)
+```ruby
+def to_api_file(file)
+  { base64: Base64.encode64(file.read), filename: file.original_filename }
+end
+```
+```ruby
+# rspec example
+let(:avatar) { Rack::Test::UploadedFile.new(Rails.root.join('spec/support/assets/test-image.png'), 'image/png') }
+let(:params) { { user: attributes_for(:user).merge!(avatar: to_api_file(avatar)) } }
+```
 
 ## Development
 

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/model/api_attachable.rb

@@ -0,0 +1,61 @@
+require 'active_support/concern'
+
+module Readymade
+  module Model
+    module ApiAttachable
+      extend ActiveSupport::Concern
+      # must be included after has_one_attached, has_many_attached declaration
+      # api_file = {
+      #   base64: 'iVBORw0KGgoAAA....',
+      #   filename: 'my_avatar.png'
+      # }
+      # record.avatar = api_file 🎉
+
+      included do
+        has_one_attached_reflections.map(&:name).each do |attachment_method_name|
+          define_method("#{attachment_method_name}=") do |attachment_file|
+            attachment_file = api_attachment_to_uploaded(attachment_file) if api_attachable_format?(attachment_file)
+            super(attachment_file)
+          end
+        end
+
+        has_many_attached_reflections.map(&:name).each do |attachment_method_name|
+          define_method("#{attachment_method_name}=") do |attachment_file|
+            attachment_file = Array.wrap(attachment_file).map do |af|
+              api_attachable_format?(af) ? api_attachment_to_uploaded(af) : af
+            end
+            super(attachment_file)
+          end
+        end
+      end
+
+      class_methods do
+        # rubocop:disable Naming/PredicateName
+        def has_one_attached_reflections
+          reflect_on_all_attachments.filter { |association| association.instance_of?(ActiveStorage::Reflection::HasOneAttachedReflection) }
+        end
+
+        def has_many_attached_reflections
+          reflect_on_all_attachments.filter { |association| association.instance_of?(ActiveStorage::Reflection::HasManyAttachedReflection) }
+        end
+        # rubocop:enable Naming/PredicateName
+      end
+
+      def api_attachable_format?(attachment_file)
+        attachment_file.respond_to?(:key?) && attachment_file.key?('base64') && attachment_file.key?('filename')
+      end
+
+      def api_attachment_to_uploaded(attachment_file)
+        ActionDispatch::Http::UploadedFile.new(
+          tempfile: Tempfile.new(attachment_file[:filename]).tap do |tf|
+            tf.binmode
+            tf.write(Base64.decode64(attachment_file[:base64]))
+          end,
+          filename: attachment_file[:filename],
+          type: Mime::Type.lookup_by_extension(File.extname(attachment_file[:filename])[1..]).to_s
+        )
+      end
+    end
+  end
+end
+

data/lib/readymade/version.rb

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

data/lib/readymade.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'readymade/model/api_attachable'
 require 'readymade/controller/serialization'
 require 'readymade/action'
 require 'readymade/form'

data/readymade.gemspec

@@ -25,6 +25,7 @@ Gem::Specification.new do |spec|
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
+  spec.files << 'lib/readymade/model/api_attachable.rb'
   spec.files << 'lib/readymade/controller/serialization.rb'
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: readymade
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.4
 platform: ruby
 authors:
 - OrestF
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-04-13 00:00:00.000000000 Z
+date: 2022-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -76,6 +76,7 @@ files:
 - lib/readymade/controller/serialization.rb
 - lib/readymade/form.rb
 - lib/readymade/instant_form.rb
+- lib/readymade/model/api_attachable.rb
 - lib/readymade/operation.rb
 - lib/readymade/response.rb
 - lib/readymade/version.rb