bbservices 0.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 22aeb43995310deb16fea74f6252366b8ca9317fbbcbba4a11f14d6043c9ece5
-  data.tar.gz: bb7f6388efc24fc4aa503979947572073a2971c81004484daedff1af7b12a903
+  metadata.gz: a49db154b10753f348203bbc19442fd51843284a04e234d979987d0112350ba1
+  data.tar.gz: a2bfd7d600dbb1e8532c991aa2fe21f2f6a60d8d80e2e7defc97398f7d6fcb8e
 SHA512:
-  metadata.gz: 021d855f30e314293d71a97ac2ff52cdf42cea8b1de756e40ecfa813c31c42a9ada46ceb81f133ebefd9d258fe495ac2f4bb65c31439885a60f6c30d96bec754
-  data.tar.gz: 4c3f86baaa06b0b34e7c6d3b17b7ddf650539c15ca3f107c6082891701e3816299b9610b8a3458997c9cbd9d299784457323c89e507fca55545fd2ac63190195
+  metadata.gz: 55fda5b3d407d2a47cc311a849d12dcc6653bda3af5ee9b9b148b9a4400f7df7ace55c1739cb0f4d2310cd182768e7d42ee70c7189d1b2cc3c8d3d02b1753c64
+  data.tar.gz: e29fab244b847f80eaa751a4c54120cbb8ad4e8edcec1ca597dbdfcc2a697c51218b471f32106e1fdf7c22b2b23be41e95dd35f0be837facfa5e94d263538a15

data/lib/bbservices.rb

@@ -1,6 +1,2 @@
-require_relative "base/service"
-require_relative "rails/service"
-require_relative "rails/new"
-require_relative "rails/destroy"
-require_relative "rails/create"
-require_relative "rails/create_transactioned"
+require_relative 'bbservices/service'
+require_relative 'bbservices/service_provider'

data/lib/bbservices/service.rb

@@ -0,0 +1,203 @@
+
+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 = {}, &block)
+      self.new(params).tap do |service|
+        service.run(&block)
+      end
+    end
+
+    ##
+    # Creates a new service class, then calls run! 
+    def self.run!(params = {}, &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 = {})
+      ##
+      # 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
+        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
+        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 number_of_params
+      @params ? @params.length : 0
+    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 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,28 +1,71 @@
 --- !ruby/object:Gem::Specification
 name: bbservices
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 2.1.0
 platform: ruby
 authors:
 - Stuart Farnaby, Big Bear Studios
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-06-16 00:00:00.000000000 Z
-dependencies: []
-description: 
-email: 
+date: 2021-02-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.9.0
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.86.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.86.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.18.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.18.5
+description:
+email:
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/base/service.rb
 - lib/bbservices.rb
+- lib/bbservices/service.rb
+- lib/bbservices/service_provider.rb
 homepage: https://gitlab.com/big-bear-studios-open-source/bbservices
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -38,7 +81,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.0.1
-signing_key: 
+signing_key:
 specification_version: 4
-summary: A simple service library for Ruby / Rails
+summary: A simple service library for Ruby. Please see BBActiveRecordServices for
+  a Rails / AR service library
 test_files: []

data/lib/base/service.rb

@@ -1,147 +0,0 @@
-module BBServices
-
-  ##
-  # This class handles the building of a basic / generic service
-  class Service
-
-    def self.service_class(klass)
-      @service_class = klass
-    end
-
-    def initialize
-
-      @object = nil
-
-      @successful = false
-
-      @errors = nil
-
-      @service_class = nil
-    end
-
-    def service_class=(klass)
-      @service_class = klass
-    end
-
-    def service_class
-      @service_class ? @service_class : self.class.instance_variable_get(:@service_class)
-    end
-
-    def run(&block)
-      begin
-        initialize_service
-        run_service
-      rescue StandardError => e
-        set_successful(false)
-        set_error(e)
-      ensure
-        call_block(&block)
-      end
-    end
-
-    def run!(&block)
-      begin
-        initialize_service
-        run_service!
-      rescue StandardError => e
-        set_successful(false)
-        set_error(e)
-        raise e
-      end
-    end
-
-    def params=(params)
-      @params = params
-    end
-
-    def associated_params=(params)
-      @associated_params = params
-    end
-
-    def params
-      @params
-    end
-
-    def associated_params
-      @associated_params
-    end
-
-    def param_for(key)
-      if @params
-        @params[key]
-      end
-    end
-
-    def associated_param_for(key)
-      if @associated_params
-        @associated_params[key]
-      end
-    end
-
-    def succeeded?
-      (@successful && !has_errors? )
-    end
-
-    def failed?
-      !succeeded?
-    end
-
-    def success(&block)
-      if succeeded?
-        yield
-      end
-    end
-
-    def failure(&block)
-      if failed?
-        yield
-      end
-    end
-
-    def object
-      @object
-    end
-
-    def errors
-      @errors
-    end
-
-    def has_errors?
-      @errors && @errors.length > 0
-    end
-
-    protected
-
-    def initialize_service
-
-    end
-
-    def run_service
-      @successful = true
-    end
-
-    def run_service!
-      @successful = true
-    end
-
-    def set_error(error)
-      if !@errors
-        @errors = []
-      end
-
-      @errors << error
-    end
-
-    def set_successful(successful = true)
-      @successful = successful
-    end
-
-    private
-
-    def call_block(&block)
-      if block_given?
-        yield(self)
-      end
-    end
-  end
-end