bbservices 1.0.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b254da2dd4d69b3079db77abc649b7144c7ad05d381c51133b2404370a197185
-  data.tar.gz: 132f8d5843c24f3646262dbbf303a928e934e7255690e108c3edc405c4320500
+  metadata.gz: 48cb6bb977e6fad5a1efd70a3dadab0366860eaa84ac41749877acc06017ae2c
+  data.tar.gz: 38a78f0ae7a47fe6f57a35724e55b9fc4e55131af57a222c099b5a1fb1d98095
 SHA512:
-  metadata.gz: 9f4a2e78e0dc97e47988614fc88960d02c077336465ab3ae40fee9228260e683d6f896374a21db2c7c3dd37d12af65dc76f73b46790885b19e946b3bf5006883
-  data.tar.gz: b4b0e8451c3894bac62c5afb695771f581d73fce08c468fe02ee3995193760cf2862a1bd595eec6566a1418d9c4041d4c696df45b8bdd46c666f3384baa0aa7e
+  metadata.gz: c2d40a76870f43ee2578c50fbf40411dafb76e6fe79aafe3cdbf9bc272b4b72852c6c5e8668bb7554ad23a09904742f140eaae3f7c934c243ee0c33c67bfbd12
+  data.tar.gz: 1a45585761e068e611fe125c96b7386f7f1872047b610ae793da213698de60e025d9f0ed63514c26b1afbb96d64d045132f6b329335238a72a0054bece284030

data/lib/bbservices.rb

@@ -1,2 +1,2 @@
-require_relative 'service'
-require_relative 'service_provider'
+require_relative 'bbservices/service'
+require_relative 'bbservices/service_provider'

data/lib/bbservices/service.rb

@@ -0,0 +1,205 @@
+
+module BBServices
+  ##
+  # The base class for all services. Handles the basic run loop and general accessors
+  class Service
+    attr_reader :params, :object, :errors
+
+    ##
+    # Creates a new service class, then calls run
+    def self.run(params = nil, &block)
+      self.new(params).tap do |service|
+        service.run(&block)
+      end
+    end
+
+    ##
+    # Creates a new service class, then calls run! 
+    def self.run!(params = nil, &block)
+      self.new(params).tap do |service|
+        service.run!(&block)
+      end
+    end
+
+    ##
+    # Sets the service class
+    def self.service_class(klass)
+      @service_class = klass
+    end
+
+    ##
+    # Gets the service class
+    def self.get_service_class
+      @service_class
+    end
+
+    def initialize(params = nil)
+      ##
+      # The object which will be assigned to the service
+      @object = nil
+
+      ##
+      # The state of success, was the service successful
+      @successful = false
+
+      ##
+      # The state of the run, has the service being ran
+      @ran = false
+
+      ##
+      # The errors which are returned by the service
+      @errors = nil
+
+      ##
+      # The service class stored on the instance. This will override the
+      # service class set statically
+      @service_class = nil
+
+      ##
+      # The params passed to the resource
+      @params = params
+    end
+
+    ##
+    # This runs the safe version of the service. E.g. Will rescue on exception
+    # and set the error attribute
+    def run(&block)
+      set_ran
+      begin
+        initialize_service
+        internal_validation
+        run_service
+      rescue StandardError => e
+        set_successful(false)
+        set_error(e)
+      ensure
+        call_block(&block)
+      end
+    end
+
+    ##
+    # This runs the unsafe version of the service. E.g. Exceptions will be thrown
+    def run!(&block)
+      set_ran
+      begin
+        initialize_service
+        internal_validation
+        run_service!
+        call_block(&block)
+      rescue StandardError => e
+        set_successful(false)
+        set_error(e)
+        raise e
+      end
+    end
+
+    def set_service_class(value)
+      @service_class = value
+    end
+
+    ##
+    # Sets the service_class instance variable
+    def service_class=(value)
+      set_service_class(value)
+    end
+
+    ##
+    # Gets the service_class. This will go instance first, then static
+    def service_class
+      @service_class || self.class.get_service_class
+    end
+
+    def set_params(value)
+      @params = value
+    end
+
+    def params=(value)
+      set_params(value)
+    end
+
+    def param_for(key)
+      param(key)
+    end
+
+    def param(key)
+      @params[key] if @params
+    end
+
+    def ran?
+      @ran
+    end
+
+    def succeeded?
+      (@successful && !errors?)
+    end
+
+    def successful?
+      (@successful && !errors?)
+    end
+
+    def failed?
+      !succeeded?
+    end
+
+    def success(&block)
+      call_block(&block) if succeeded?
+    end
+
+    def failure(&block)
+      call_block(&block) if failed?
+    end
+
+    def errors?
+      !!(@errors && @errors.length.positive?)
+    end
+
+    def params?
+      !!@params
+    end
+
+    protected
+
+    def initialize_service() end
+
+    def run_service
+      set_successful
+      set_object(nil)
+    end
+
+    def run_service!
+      set_successful
+      set_object(nil)
+    end
+
+    def set_object(obj)
+      @object = obj
+    end
+
+    def set_error(error)
+      set_errors([]) unless @errors
+      @errors << error
+    end
+
+    def set_errors(errors)
+      @errors = errors
+    end
+
+    def set_successful(successful = true)
+      @successful = successful
+    end
+
+    def set_ran(ran = true)
+      @ran = ran
+    end
+
+    private
+
+    def internal_validation
+      set_params({}) unless params?
+    end
+
+    def call_block
+      yield(self) if block_given?
+    end
+  end
+end

data/lib/bbservices/service_provider.rb

@@ -0,0 +1,42 @@
+
+module BBServices 
+  ##
+  # 
+  module ServiceProvider
+    def self.included(base)
+      base.extend ClassMethods
+      base.class_eval do
+
+        ##
+        # Creates a brand new service of a given type
+        def service(service_type, service_params = {})
+          service_type.new.tap do |service|
+            service.set_params(service_params)
+          end
+        end
+
+        ##
+        # Creates and runs a brand new service using the safe method
+        def run_service(service_type, service_params = {}, &block)
+          service(service_type, service_params).tap do |service|
+            service.set_service_class(service_type)
+            service.run(&block)
+          end
+        end
+
+        ##
+        # Creates and runs a brand new service using the unsafe method
+        def run_service!(service_type, service_params = {}, &block)
+          service(service_type, service_params).tap do |service|
+            service.set_service_class(service_type)
+            service.run!(&block)
+          end
+        end
+      end
+    end
+
+    module ClassMethods
+      
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bbservices
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Stuart Farnaby, Big Bear Studios
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-06-16 00:00:00.000000000 Z
+date: 2021-02-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -59,8 +59,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/bbservices.rb
-- lib/service.rb
-- lib/service_provider.rb
+- lib/bbservices/service.rb
+- lib/bbservices/service_provider.rb
 homepage: https://gitlab.com/big-bear-studios-open-source/bbservices
 licenses:
 - MIT

data/lib/service.rb

@@ -1,198 +0,0 @@
-
-##
-# The base class for all services. Handles the basic run loop and general accessors
-class Service
-  attr_reader :params, :object, :errors
-
-  ##
-  # Creates a new service class, then calls run
-  def self.run(params = nil, &block)
-    self.new(params).tap do |service|
-      service.run(&block)
-    end
-  end
-
-  ##
-  # Creates a new service class, then calls run! 
-  def self.run!(params = nil, &block)
-    self.new(params).tap do |service|
-      service.run!(&block)
-    end
-  end
-
-  def self.service_class(klass)
-    @service_class = klass
-  end
-
-  def self.get_service_class
-    @service_class
-  end
-
-  def initialize(params = nil)
-    ##
-    # The object which will be assigned to the service
-    @object = nil
-
-    ##
-    # The state of success, was the service successful
-    @successful = false
-
-    ##
-    # The state of the run, has the service being ran
-    @ran = false
-
-    ##
-    # The errors which are returned by the service
-    @errors = nil
-
-    ##
-    # The service class stored on the instance. This will override the
-    # service class set statically
-    @service_class = nil
-
-    ##
-    # The params passed to the resource
-    @params = params
-  end
-
-  ##
-  # This runs the safe version of the service. E.g. Will rescue on exception
-  def run(&block)
-    set_ran
-    begin
-      initialize_service
-      internal_validation
-      run_service
-    rescue StandardError => e
-      set_successful(false)
-      set_error(e)
-    ensure
-      call_block(&block)
-    end
-  end
-
-  ##
-  # This runs the unsafe version of the service. E.g. Exceptions will be thrown
-  def run!(&block)
-    set_ran
-    begin
-      initialize_service
-      internal_validation
-      run_service!
-      call_block(&block)
-    rescue StandardError => e
-      set_successful(false)
-      set_error(e)
-      raise e
-    end
-  end
-
-  def set_service_class(value)
-    @service_class = value
-  end
-
-  ##
-  # Sets the service_class instance variable
-  def service_class=(value)
-    set_service_class(value)
-  end
-
-  ##
-  # Gets the service_class. This will go instance first, then static
-  def service_class
-    @service_class || self.class.get_service_class
-  end
-
-  def set_params(value)
-    @params = value
-  end
-
-  def params=(value)
-    set_params(value)
-  end
-
-  def param_for(key)
-    param(key)
-  end
-
-  def param(key)
-    @params[key] if @params
-  end
-
-  def ran?
-    @ran
-  end
-
-  def succeeded?
-    (@successful && !errors?)
-  end
-
-  def successful?
-    (@successful && !errors?)
-  end
-
-  def failed?
-    !succeeded?
-  end
-
-  def success(&block)
-    call_block(&block) if succeeded?
-  end
-
-  def failure(&block)
-    call_block(&block) if failed?
-  end
-
-  def errors?
-    !!(@errors && @errors.length.positive?)
-  end
-
-  def params?
-    !!@params
-  end
-
-  protected
-
-  def initialize_service() end
-
-  def run_service
-    set_successful
-    set_object(nil)
-  end
-
-  def run_service!
-    set_successful
-    set_object(nil)
-  end
-
-  def set_object(obj)
-    @object = obj
-  end
-
-  def set_error(error)
-    set_errors([]) unless @errors
-    @errors << error
-  end
-
-  def set_errors(errors)
-    @errors = errors
-  end
-
-  def set_successful(successful = true)
-    @successful = successful
-  end
-
-  def set_ran(ran = true)
-    @ran = ran
-  end
-
-  private
-
-  def internal_validation
-    set_params({}) unless params?
-  end
-
-  def call_block
-    yield(self) if block_given?
-  end
-end

data/lib/service_provider.rb

@@ -1,36 +0,0 @@
-
-##
-# 
-module ServiceProvider
-  def self.included(base)
-    base.extend ClassMethods
-    base.class_eval do
-
-      ##
-      # Creates a brand new service of a given type
-      def service(service_type, service_params = {})
-        service_type.new.tap do |service|
-          service.set_params(service_params)
-        end
-      end
-
-      def run_service(service_type, service_params = {}, &block)
-        service(service_type, service_params).tap do |service|
-          service.set_service_class(service_type)
-          service.run(&block)
-        end
-      end
-
-      def run_service!(service_type, service_params = {}, &block)
-        service(service_type, service_params).tap do |service|
-          service.set_service_class(service_type)
-          service.run!(&block)
-        end
-      end
-    end
-  end
-
-  module ClassMethods
-    
-  end
-end