pi-resources-rails 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cd8544e753ce20c755b5a633b82236c5e385a4265ce856f11066621b75bd8957
+  data.tar.gz: eacbef0fc52c69b02dc9d1584d369329460b00b44eec9eeb79ed9fe19ca10303
+SHA512:
+  metadata.gz: cc5e99e7249c72f4bf1a2c5677e679ae9e45e6577d0031f83298048106b9f3b40fd5753cb6219e4581a92999db4df708184f03158df6b222cbb5bbd19b08436e
+  data.tar.gz: 862f5be3a73c083b65315ea8087d3183160ec641e3589ff642c044ee1011c055482270f39fd99c17b64f4610107e6cb64369fed2537d48d1a9120c112330ad14

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2023 Umberto Peserico
+
+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,28 @@
+# PiResources
+Short description and motivation.
+
+## Usage
+How to use my plugin.
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem "pi_resources"
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install pi_resources
+```
+
+## Contributing
+Contribution directions go here.
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'bundler/setup'
+
+require 'bundler/gem_tasks'

data/lib/pi_resources/method_not_overridden_error.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module PiResources
+  class MethodNotOverriddenError < StandardError
+    def initialize(method, object)
+      super("Method #{method} not overridden in #{object}")
+    end
+  end
+end

data/lib/pi_resources/params_helpers.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module PiResources
+  module ParamsHelpers
+    extend ActiveSupport::Concern
+
+    def request_params
+      request.request_parameters.to_h.deep_symbolize_keys
+    end
+
+    def query_params
+      request.query_parameters.deep_transform_keys(&:underscore).deep_symbolize_keys
+    end
+  end
+end

data/lib/pi_resources/railtie.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module PiResources
+  class Railtie < ::Rails::Railtie
+  end
+end

data/lib/pi_resources/renderers.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+ActionController::Renderers.add :resource do |resource, options|
+  options = options.slice(:serializer, :meta, :message, :context, :message, :location)
+
+  puts options.inspect
+
+  result = options[:serializer].new(resource, meta: options[:meta], message: options[:message]).as_json
+
+  self.content_type = Mime[:json]
+
+  result
+end
+
+ActionController::Renderers.add :resource_errors do |errors, _options|
+  result = PiResources::Serializer::ResourceErrorsSerializer.new(errors).as_json
+
+  self.content_type = Mime[:json]
+
+  result
+end

data/lib/pi_resources/resources_controller.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+require 'debug'
+
+module PiResources
+  module ResourcesController
+    extend ActiveSupport::Concern
+
+    def index
+      @resource_collection = resource_collection_resolver
+
+      render resource:   @resource_collection,
+             serializer: index_resource_serializer,
+             context:    context
+    end
+
+    def show
+      @resource = resource_finder
+
+      render resource:   @resource,
+             serializer: show_resource_serializer,
+             context:    context,
+             location:   resource_location
+    end
+
+    def create
+      @resource = resource_creator
+
+      if @resource.valid?
+        render resource:   @resource,
+               serializer: create_resource_serializer,
+               context:    context,
+               message:    create_message,
+               location:   resource_location
+      else
+        render resource_errors: @resource.errors
+      end
+    end
+
+    def update
+      @resource = resource_updater
+
+      if @resource.valid?
+        render resource:   @resource,
+               serializer: update_resource_serializer,
+               context:    context,
+               message:    update_message,
+               location:   resource_location
+      else
+        render resource_errors: @resource.errors
+      end
+    end
+
+    def destroy
+      @resource = resource_destroyer
+
+      if @resource.valid?
+        render resource:   @resource,
+               serializer: destroy_resource_serializer,
+               context:    context,
+               message:    destroy_message,
+               location:   resource_location
+      else
+        render resource_errors: @resource.errors
+      end
+    end
+
+    protected
+
+    def context
+      @context ||= {}
+    end
+
+    def resource_service
+      resource_service_class.new
+    end
+
+    def resource_service_class
+      raise MethodNotOverriddenError.new(__method__, self)
+    end
+
+    def resource_serializer
+      raise MethodNotOverriddenError.new(__method__, self)
+    end
+
+    def resource_location
+      raise MethodNotOverriddenError.new(__method__, self)
+    end
+
+    def resource_params_root_key
+      raise MethodNotOverriddenError.new(__method__, self)
+    end
+
+    def create_message
+      nil
+    end
+
+    def update_message
+      nil
+    end
+
+    def destroy_message
+      nil
+    end
+
+    def resource_params
+      @resource_params ||= request_params.fetch(resource_params_root_key)
+    rescue KeyError => e
+      raise ActionController::ParameterMissing, e
+    end
+
+    def context=(context)
+      self.context.merge!(context)
+    end
+
+    def index_resource_serializer
+      resource_serializer
+    end
+
+    def show_resource_serializer
+      resource_serializer
+    end
+
+    def create_resource_serializer
+      resource_serializer
+    end
+
+    def update_resource_serializer
+      resource_serializer
+    end
+
+    def destroy_resource_serializer
+      resource_serializer
+    end
+
+    def resource_collection_resolver
+      resource_service.all
+    end
+
+    def resource_finder
+      resource_service.find(resource_key_param)
+    end
+
+    def resource_creator
+      resource_service.create(resource_create_params)
+    end
+
+    def resource_updater
+      resource_service.update(resource_key_param, resource_update_params)
+    end
+
+    def resource_destroyer
+      resource_service.destroy(resource_key_param)
+    end
+
+    def resource_key_param
+      params[:id]
+    end
+
+    def resource_create_params
+      resource_params
+    end
+
+    def resource_update_params
+      resource_params
+    end
+  end
+end

data/lib/pi_resources/serializer/base.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module PiResources
+  module Serializer
+    module Base
+      extend ActiveSupport::Concern
+
+      TRANSFORMS_MAPPING = {
+        camel_lower: %i[camelize lower],
+        underscore:  :underscore,
+      }.freeze
+
+      included do
+        cattr_accessor :transform_method_value, default: TRANSFORMS_MAPPING[:camel_lower]
+      end
+
+      def as_json(opts = nil)
+        JSON.generate(result, opts)
+      end
+
+      def to_h
+        result
+      end
+
+      alias to_hash to_h
+
+      def serializable_hash!
+        nil
+      end
+
+      def run_key_transform!(key)
+        key.to_s.send(*transform_method_value).to_sym
+      end
+
+      class_methods do
+        def transform_method(transform_method)
+          unless TRANSFORMS_MAPPING.key?(transform_method)
+            raise StandardError, "Transform method must be equal to #{TRANSFORMS_MAPPING.keys}"
+          end
+
+          self.transform_method_value = TRANSFORMS_MAPPING[transform_method]
+        end
+
+        def collection?(resource)
+          resource.is_a?(Enumerable) && !resource.respond_to?(:each_pair)
+        end
+      end
+
+      private
+
+      def result
+        @result ||= serializable_hash!
+      end
+    end
+  end
+end

data/lib/pi_resources/serializer/exception_serializer.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require 'pi_resources/serializer/base'
+
+module PiResources
+  module Serializer
+    class ExceptionSerializer
+      include Base
+
+      attr_reader :error, :status, :exception, :root
+
+      def initialize(status: nil, error: nil, exception: nil, root: true)
+        @error     = error
+        @status    = status
+        @exception = exception
+        @root      = root
+      end
+
+      protected
+
+      def serializable_hash!
+        data   = {}
+        result = {}
+
+        data[run_key_transform!(:status)]    = status
+        data[run_key_transform!(:error)]     = error if error
+        data[run_key_transform!(:exception)] = exception if exception
+
+        if root
+          result[run_key_transform!(:validation_response)] = data
+          result
+        else
+          data
+        end
+      end
+    end
+  end
+end

data/lib/pi_resources/serializer/hash_serializer.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'json'
+
+require 'pi_resources/serializer/base'
+
+module PiResources
+  module Serializer
+    class HashSerializer
+      include Base
+
+      attr_reader :hash, :meta, :message, :root
+
+      def initialize(resource, meta: nil, message: nil, context: nil, root: true)
+        @hash     = resource
+        @resource = resource
+        @meta     = meta
+        @message  = message
+        @context  = context || {}
+        @root     = root
+      end
+
+      def data
+        hash
+      end
+
+      protected
+
+      def serializable_hash!
+        if root
+          result = {}
+
+          result[run_key_transform!(:data)]    = serialize_data
+          result[run_key_transform!(:meta)]    = meta&.deep_transform_keys { |key| run_key_transform!(key) } if meta
+          result[run_key_transform!(:message)] = message if message
+
+          result
+        else
+          serialize_data
+        end
+      end
+
+      def serialize_data
+        if self.class.collection? @resource
+          @resource.map { |o| o.deep_transform_keys { |key| run_key_transform!(key) } }
+        else
+          @resource&.deep_transform_keys { |key| run_key_transform!(key) }
+        end
+      end
+    end
+  end
+end

data/lib/pi_resources/serializer/money_serializer.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'pi_resources/serializer/object_serializer'
+
+module PiResources
+  module Serializer
+    class MoneySerializer
+      include ObjectSerializer
+
+      attribute :cents, method: :cents
+      attribute :amount, method: :amount
+      attribute :currency, method: :currency
+      attribute :formatted_text, method: :formatted_text
+      attribute :symbol, method: :symbol
+
+      def cents(record)
+        record.cents
+      end
+
+      def amount(record)
+        record.to_f
+      end
+
+      def currency(record)
+        record.currency.iso_code
+      end
+
+      def formatted_text(record)
+        record.format(symbol: "#{record.currency.symbol} ")
+      end
+
+      def symbol(record)
+        record.currency.symbol
+      end
+    end
+  end
+end

data/lib/pi_resources/serializer/object_serializer.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require 'pi_resources/serializer/base'
+
+module PiResources
+  module Serializer
+    module ObjectSerializer
+      extend ActiveSupport::Concern
+      include Base
+
+      included do
+        class << self
+          attr_writer :attributes_to_serialize
+
+          def attributes_to_serialize
+            @attributes_to_serialize ||= []
+          end
+        end
+
+        attr_reader :resource, :message, :context, :root
+      end
+
+      def initialize(resource, meta: nil, message: nil, context: nil, root: true)
+        @resource = resource
+        @meta     = meta
+        @message  = message
+        @context  = context || {}
+        @root     = root
+      end
+
+      class_methods do
+        def attribute(key, options = {})
+          attributes_to_serialize.push({
+                                         name: key,
+                                         **options.slice(:method, :serializer, :serialize_if),
+                                       })
+        end
+      end
+
+      def data
+        if self.class.collection? @resource
+          data_for_collection
+        else
+          data_for_one_record
+        end
+      end
+
+      def meta
+        @meta&.deep_transform_keys do |k|
+          run_key_transform!(k)
+        end
+      end
+
+      def serializable_hash!
+        if root
+          use_root
+        else
+          data
+        end
+      end
+
+      private
+
+      def data_for_collection
+        @resource.map { |el| build_record(el) }
+      end
+
+      def data_for_one_record
+        build_record(@resource) if @resource
+      end
+
+      def build_record(record)
+        self.class.attributes_to_serialize.each_with_object({}) do |attr, hash|
+          name         = attr[:name]
+          serializer   = attr[:serializer]
+          method       = attr[:method]
+          serialize_if = attr[:serialize_if]
+
+          next if serialize_if && !serialize_if.call(context)
+
+          hash[run_key_transform!(name)] = if serializer.present?
+                                             attr[:serializer].new(record.send(name), root: false, context: context)
+                                               .to_h
+                                           elsif method.present?
+                                             send(method, record)
+                                           else
+                                             record.send(name)
+                                           end
+        end
+      end
+
+      def use_root
+        result = {}
+
+        result[run_key_transform!(:data)]    = data
+        result[run_key_transform!(:meta)]    = meta if @meta.present?
+        result[run_key_transform!(:message)] = message if @message.present?
+
+        result
+      end
+    end
+  end
+end

data/lib/pi_resources/serializer/resource_errors_serializer.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'pi_resources/serializer/base'
+
+module PiResources
+  module Serializer
+    class ResourceErrorsSerializer
+      include Base
+
+      def initialize(errors)
+        @resource             = errors
+      end
+
+      private
+
+      def errors
+        @resource.full_messages
+      end
+
+      def details
+        @resource.details.each_with_object({}) do |error, result|
+          field                             = error[0]
+          errors                            = error[1]
+          result[run_key_transform!(field)] = errors.map do |e|
+            e.each_with_object({}) do |obj, result2|
+              if obj[0] == :error
+                result2[:error] = run_key_transform!(obj[1])
+              else
+                result2[run_key_transform!(obj[0])] = obj[1]
+              end
+            end
+          end
+        end
+      end
+
+      def serializable_hash!
+        result = {}
+
+        result[run_key_transform!(:errors)]  = errors
+        result[run_key_transform!(:details)] = details
+
+        result
+      end
+    end
+  end
+end

data/lib/pi_resources/serializer/smart_hash_serializer.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'pi_resources/serializer/money_serializer'
+
+module PiResources
+  module Serializer
+    class SmartHashSerializer < HashSerializer
+      def initialize(resource, meta: nil, message: nil, context: nil, root: true)
+        super(
+          check_type(resource),
+          meta:    meta,
+          message: message,
+          context: context,
+          root:    root,
+        )
+      end
+
+      private
+
+      def check_type(stuff)
+        case stuff
+        when Array
+          stuff.map { |s| check_type(s) }
+        when Hash
+          stuff.transform_values { |v| check_type(v) }
+        when Money
+          MoneySerializer.new(stuff, root: false).data
+        else
+          stuff
+        end
+      end
+    end
+  end
+end

data/lib/pi_resources/serializer/validation_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'active_model'
+
+module PiResources
+  module Serializer
+    class ValidationResponse
+      include ActiveModel::Model
+      include ActiveModel::Attributes
+      include ActiveModel::Serialization
+
+      attribute :id, type: :string
+      attribute :status, type: :integer
+      attribute :message, type: :string
+    end
+  end
+end

data/lib/pi_resources/serializer/validation_response_serializer.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'pi_resources/serializer/base'
+
+module PiResources
+  module Serializer
+    class ValidationResponseSerializer
+      include Base
+
+      attr_reader :message
+
+      def initialize(resource, message = nil)
+        @resource             = resource
+        @message              = message
+      end
+
+      protected
+
+      def validation_response
+        @resource.attributes.symbolize_keys.deep_transform_keys do |k|
+          run_key_transform!(k)
+        end
+      end
+
+      def serializable_hash!
+        result = {}
+
+        result[run_key_transform!(:validation_response)] = validation_response
+        result[run_key_transform!(:message)]             = message if message
+
+        result
+      end
+    end
+  end
+end

data/lib/pi_resources/serializer.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module PiResources
+  module Serializer
+  end
+end

data/lib/pi_resources/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module PiResources
+  VERSION = '0.1.0'
+end

data/lib/pi_resources.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'active_support/all'
+require 'active_model'
+require 'json'
+require 'money'
+
+require 'pi_resources/version'
+require 'pi_resources/railtie' if defined? Rails
+require 'pi_resources/serializer'
+require 'pi_resources/serializer/base'
+require 'pi_resources/serializer/exception_serializer'
+require 'pi_resources/serializer/hash_serializer'
+require 'pi_resources/serializer/money_serializer'
+require 'pi_resources/serializer/object_serializer'
+require 'pi_resources/serializer/resource_errors_serializer'
+require 'pi_resources/serializer/smart_hash_serializer'
+require 'pi_resources/serializer/validation_response_serializer'
+require 'pi_resources/serializer/validation_response'
+require 'pi_resources/method_not_overridden_error'
+
+require 'pi_resources/renderers' if defined? Rails
+require 'pi_resources/resources_controller' if defined? Rails
+require 'pi_resources/params_helpers' if defined? Rails
+
+module PiResources
+end

data/lib/tasks/pi_resource_tasks.rake

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+# desc "Explaining what the task does"
+# task :pi_resources do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: pi-resources-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Umberto Peserico
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-08-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: money
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+description: Description of PiResource
+email:
+- umberto.peserico@pandev.it
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/pi_resources.rb
+- lib/pi_resources/method_not_overridden_error.rb
+- lib/pi_resources/params_helpers.rb
+- lib/pi_resources/railtie.rb
+- lib/pi_resources/renderers.rb
+- lib/pi_resources/resources_controller.rb
+- lib/pi_resources/serializer.rb
+- lib/pi_resources/serializer/base.rb
+- lib/pi_resources/serializer/exception_serializer.rb
+- lib/pi_resources/serializer/hash_serializer.rb
+- lib/pi_resources/serializer/money_serializer.rb
+- lib/pi_resources/serializer/object_serializer.rb
+- lib/pi_resources/serializer/resource_errors_serializer.rb
+- lib/pi_resources/serializer/smart_hash_serializer.rb
+- lib/pi_resources/serializer/validation_response.rb
+- lib/pi_resources/serializer/validation_response_serializer.rb
+- lib/pi_resources/version.rb
+- lib/tasks/pi_resource_tasks.rake
+homepage: https://bitbucket.org/pandev-srl/pi-resources-rails
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  homepage_uri: https://bitbucket.org/pandev-srl/pi-resources-rails
+  source_code_uri: https://bitbucket.org/pandev-srl/pi-resources-rails
+  changelog_uri: https://bitbucket.org/pandev-srl/pi-resources-rails
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Summary of PiResource
+test_files: []