light-services 0.5.4 → 2.0.0.beta1

data/lib/light/services/collection/outputs.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# Collection to store outputs values
+module Light
+  module Services
+    module Collection
+      class Outputs < Base
+        private
+
+        def settings_collection
+          @instance.class.outputs
+        end
+      end
+    end
+  end
+end

data/lib/light/services/config.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Light
+  module Services
+    class << self
+      def configure
+        yield config
+      end
+
+      def config
+        @config ||= Config.new
+      end
+    end
+
+    class Config
+      # Constants
+      DEFAULTS = {
+        use_transactions: true,
+
+        load_errors: true,
+        break_on_error: true,
+        raise_on_error: false,
+        rollback_on_error: true,
+
+        load_warnings: true,
+        break_on_warning: false,
+        raise_on_warning: false,
+        rollback_on_warning: false
+      }.freeze
+
+      # Getters / Setters
+      attr_accessor :use_transactions,
+                    :load_errors, :break_on_error, :raise_on_error, :rollback_on_error,
+                    :load_warnings, :break_on_warning, :raise_on_warning, :rollback_on_warning
+
+      def initialize
+        reset_to_defaults!
+      end
+
+      def set(key, value)
+        instance_variable_set("@#{key}", value)
+      end
+
+      def get(key)
+        instance_variable_get("@#{key}")
+      end
+
+      def reset_to_defaults!
+        DEFAULTS.each do |key, value|
+          set(key, value)
+        end
+      end
+
+      def to_h
+        DEFAULTS.keys.map { |key| [key, get(key)] }.to_h
+      end
+
+      def merge(config)
+        to_h.merge(config)
+      end
+    end
+  end
+end

data/lib/light/services/exceptions.rb

@@ -3,7 +3,8 @@
 module Light
   module Services
     class Error < StandardError; end
-    class ParamRequired < Light::Services::Error; end
-    class ParamType < Light::Services::Error; end
+    class ArgTypeError < Error; end
+    class NoStepError < Error; end
+    class TwoConditions < Error; end
   end
 end

data/lib/light/services/messages.rb

@@ -1,65 +1,108 @@
 # frozen_string_literal: true
 
+# This class stores errors and warnings
 module Light
   module Services
     class Messages
-      def initialize
-        @storage = {}
+      def initialize(config)
+        @break = false
+        @config = config
+        @messages = {}
       end
 
-      def add(key, message)
-        storage[key] ||= []
-        storage[key] << message
-      end
+      def add(key, message, opts = {})
+        @messages[key] ||= []
 
-      def from_record(record)
-        record.errors.to_h.each do |key, message|
-          add(key, message)
+        if message.is_a?(Array)
+          @messages[key] += message
+        else
+          @messages[key] << message
         end
-      end
 
-      def from_service(service)
-        service.errors.each do |key, message|
-          add(key, message)
-        end
+        raise!(key, message)
+        break!(opts[:break])
+        rollback!(opts[:rollback])
       end
 
-      def delete(key)
-        storage.delete(key)
+      def break?
+        @break
       end
 
-      def blank?
-        storage.empty?
+      def copy_from(entity, opts = {})
+        if defined?(ActiveRecord::Base) && entity.is_a?(ActiveRecord::Base)
+          copy_from(entity.errors.messages, opts)
+        elsif entity.respond_to?(:each)
+          entity.each do |key, message|
+            add(key, message, opts)
+          end
+        else
+          # TODO: Update error
+          raise Light::Services::Error
+        end
       end
 
-      def any?
-        !blank?
-      end
+      def copy_to(entity)
+        if defined?(ActiveRecord::Base) && entity.is_a?(ActiveRecord::Base)
+          each do |key, message|
+            entity.errors.add(key, message)
+          end
+        elsif entity.is_a?(Hash)
+          each do |key, message|
+            entity[key] ||= []
+            entity[key] << message
+          end
+        else
+          # TODO: Update error
+          raise Light::Services::Error
+        end
 
-      def to_hash
-        storage
+        entity
       end
 
-      def flatten
-        to_hash.flat_map do |key, messages|
-          messages.map do |message|
-            [key, message]
-          end
+      def errors_to_record(record)
+        if !defined?(ActiveRecord::Base) || !record.is_a?(ActiveRecord::Base)
+          # TODO: Update error
+          raise Light::Services::Error
+        end
+
+        errors.each do |key, message|
+          record.errors.add(key, message)
         end
+
+        record
       end
 
-      def each
-        flatten.each do |key, message|
-          yield key, message
+      def method_missing(method, *args, &block)
+        if @messages.respond_to?(method)
+          @messages.public_send(method, *args, &block)
+        else
+          super
         end
       end
 
-      alias to_h to_hash
+      def respond_to_missing?(method, include_private = false)
+        @messages.respond_to?(method, include_private) || super
+      end
 
       private
 
-      # Getters/Setters
-      attr_accessor :storage
+      def break!(break_execution)
+        return unless break_execution.nil? ? @config[:break_on_add] : break_execution
+
+        @break = true
+      end
+
+      def raise!(key, message)
+        return unless @config[:raise_on_add]
+
+        raise Light::Services::Error, "#{key.to_s.capitalize} #{message}"
+      end
+
+      def rollback!(rollback)
+        return if !defined?(ActiveRecord::Rollback) || !(rollback.nil? ? @config[:rollback_on_add] : rollback)
+
+        raise ActiveRecord::Rollback
+      end
     end
   end
 end

data/lib/light/services/settings/argument.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# This class defines settings for argument
+module Light
+  module Services
+    module Settings
+      class Argument
+        # Getters
+        attr_reader :name, :default_exists, :default, :context, :optional
+
+        def initialize(name, service_class, opts = {})
+          @name = name
+          @service_class = service_class
+
+          @type = opts.delete(:type)
+          @context = opts.delete(:context)
+          @default_exists = opts.key?(:default)
+          @default = opts.delete(:default)
+          @optional = opts.delete(:optional)
+
+          define_methods
+        end
+
+        def valid_type?(value)
+          return if !@type || [*@type].any? do |type|
+            if type == :boolean
+              value.is_a?(TrueClass) || value.is_a?(FalseClass)
+            else
+              value.is_a?(type)
+            end
+          end
+
+          raise Light::Services::ArgTypeError, "#{@service_class} argument `#{name}` must be " \
+                                               "a #{[*@type].join(', ')} (currently: #{value.class})"
+        end
+
+        private
+
+        def define_methods
+          name = @name
+
+          @service_class.define_method(@name) { @arguments.get(name) }
+          @service_class.define_method("#{@name}?") { !!@arguments.get(name) } # rubocop:disable Style/DoubleNegation
+          @service_class.define_method("#{@name}=") { |value| @arguments.set(name, value) }
+          @service_class.send(:private, "#{@name}=")
+        end
+      end
+    end
+  end
+end

data/lib/light/services/settings/output.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# This class defines settings for output
+module Light
+  module Services
+    module Settings
+      class Output
+        # Getters
+        attr_reader :name, :default_exists, :default
+
+        def initialize(name, service_class, opts = {})
+          @name = name
+          @service_class = service_class
+
+          @default_exists = opts.key?(:default)
+          @default = opts.delete(:default)
+
+          define_methods
+        end
+
+        private
+
+        def define_methods
+          name = @name
+
+          @service_class.define_method(@name) { @outputs.get(name) }
+          @service_class.define_method("#{@name}?") { !!@outputs.get(name) } # rubocop:disable Style/DoubleNegation
+          @service_class.define_method("#{@name}=") { |value| @outputs.set(name, value) }
+          @service_class.send(:private, "#{@name}=")
+        end
+      end
+    end
+  end
+end

data/lib/light/services/settings/step.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# This class defines settings for step
+module Light
+  module Services
+    module Settings
+      class Step
+        # Getters
+        attr_reader :name, :always
+
+        def initialize(name, service_class, opts = {})
+          @name = name
+          @service_class = service_class
+
+          @if     = opts[:if]
+          @unless = opts[:unless]
+          @always = opts[:always]
+
+          if @if && @unless
+            raise Light::Services::TwoConditions, "#{service_class} `if` and `unless` cannot be specified " \
+                                                  "for the step `#{name}` at the same time"
+          end
+        end
+
+        def run(instance)
+          return false unless run?(instance)
+
+          if instance.respond_to?(name, true)
+            instance.send(name)
+            true
+          else
+            raise Light::Services::NoStepError, "Cannot find step `#{name}` in service `#{@service_class}`"
+          end
+        end
+
+        private
+
+        def run?(instance)
+          if @if
+            check_condition(@if, instance)
+          elsif @unless
+            !check_condition(@unless, instance)
+          else
+            true
+          end
+        end
+
+        def check_condition(condition, instance)
+          case condition
+          when Symbol
+            instance.public_send(condition)
+          when Proc
+            condition.call
+          else
+            raise Light::Services::Error, "#{@service_class} condition should be a Symbol or Proc " \
+                                          "for the step `#{@name}` (currently: #{condition.class})"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/light/services/version.rb

@@ -2,6 +2,6 @@
 
 module Light
   module Services
-    VERSION = '0.5.4'
+    VERSION = "2.0.0.beta1"
   end
 end

data/light-services.gemspec

@@ -1,35 +1,32 @@
-# encoding: utf-8
 # frozen_string_literal: true
 
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'light/services/version'
+require_relative "lib/light/services/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = 'light-services'
+  spec.name          = "light-services"
   spec.version       = Light::Services::VERSION
-  spec.authors       = ['Andrew Emelianenko']
-  spec.email         = ['emelianenko.web@gmail.com']
+  spec.authors       = ["Andrew Emelianenko"]
+  spec.email         = ["emelianenko.web@gmail.com"]
 
-  spec.summary       = 'Light pattern Services Object for Ruby/Rails'
-  spec.description   = 'Light pattern Services Object for Ruby/Rails from Light Ruby'
-  spec.homepage      = 'https://github.com/light-ruby/light-services'
-  spec.license       = 'MIT'
+  spec.summary       = "Powerful implementation of Service Object pattern for Ruby and Rails"
+  spec.description   = "Powerful implementation of Service Object pattern for Ruby and Rails"
+  spec.homepage      = "https://github.com/light-ruby/light-services"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
 
-  spec.files         = `git ls-files -z`
-                       .split("\x0")
-                       .reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
 
-  spec.bindir        = 'exe'
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ['lib']
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/light-ruby/light-services"
+  spec.metadata["changelog_uri"] = "https://github.com/light-ruby/light-services/blob/master/CHANGELOG.md"
 
-  spec.add_dependency 'rails', '> 4.0'
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  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.add_development_dependency 'bundler', '~> 1.12'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'appraisal', '~> 2.1'
-  spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'simplecov', '~> 0.11.2'
-  spec.add_development_dependency 'codeclimate-test-reporter'
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
 end