services_base 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1a6c9556231cf5b53f1e17362a3a3d35e4ca9792
-  data.tar.gz: be28c11b0980042cc3df8fbd92ade87509825d7b
+  metadata.gz: d38d697b9e9bd7f2c9f293a7f19142299b3aaaf2
+  data.tar.gz: 3327ca26383ffa8af40a3ae39831824c548f03e0
 SHA512:
-  metadata.gz: 58fa5fe8fda0a7d13a7ea0a3703324bc631d4d5f1249888b375298d8cf587eb1b9d0ceaef298901b2de44c11be382c59b293aa9326ecc539ef6c2f022f262e25
-  data.tar.gz: e8ec7e84e59be28abd2672c4b74ffe688b555c52dd41e95e031e9f4c86ae0ac2418246d0c20146bb8aebd8c3a276dce807b60df528494f3932591b8363de16ca
+  metadata.gz: a128d2158525202c356a78cdfd5ba3da0a7d2c91eadbf3001cd87131a439ad7a23c8dcea47699140637f2d595c454a3cf3a9ca65180c108ab7dd9fa863617e7e
+  data.tar.gz: 3617ee100b4ad20aa0cfc5f38b1fefc8ccb0baf69b37e7206f2e257cabe13ae1d01b7577af39a1f98830b656099967c5c8670c44d1b0c0b581bf8426834e5557

data/.gitignore

@@ -7,3 +7,5 @@
 /pkg/
 /spec/reports/
 /tmp/
+*.gem
+

data/Guardfile

@@ -11,32 +11,4 @@ guard :rspec, cmd: "bundle exec rspec" do
   # Ruby files
   ruby = dsl.ruby
   dsl.watch_spec_files_for(ruby.lib_files)
-
-  # # Rails files
-  # rails = dsl.rails(view_extensions: %w(erb haml slim))
-  # dsl.watch_spec_files_for(rails.app_files)
-  # dsl.watch_spec_files_for(rails.views)
-
-  # watch(rails.controllers) do |m|
-  #   [
-  #     rspec.spec.call("routing/#{m[1]}_routing"),
-  #     rspec.spec.call("controllers/#{m[1]}_controller"),
-  #     rspec.spec.call("acceptance/#{m[1]}")
-  #   ]
-  # end
-
-  # # Rails config changes
-  # watch(rails.spec_helper)     { rspec.spec_dir }
-  # watch(rails.routes)          { "#{rspec.spec_dir}/routing" }
-  # watch(rails.app_controller)  { "#{rspec.spec_dir}/controllers" }
-
-  # # Capybara features specs
-  # watch(rails.view_dirs)     { |m| rspec.spec.call("features/#{m[1]}") }
-  # watch(rails.layouts)       { |m| rspec.spec.call("features/#{m[1]}") }
-
-  # # Turnip features and steps
-  # watch(%r{^spec/acceptance/(.+)\.feature$})
-  # watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$}) do |m|
-  #   Dir[File.join("**/#{m[1]}.feature")][0] || "spec/acceptance"
-  # end
 end

data/README.md

@@ -1,6 +1,8 @@
 # ServicesBase
 
-ServicesBase is a very simple Base module for implementing Service Objects and Micro-Services in Ruby.
+ServicesBase is a very simple skeleton for implementing Service Objects and Micro-Services in Ruby.
+
+It implements a Base module for your service objects (`Services::Base`) and two Response classes (`Services::Responses::Success` and `Services::Responses::Error`).
 
 It was heavily inspired by Chris Holtz's excellent article [Organize your app with service objects](http://chrisholtz.com/blog/organize-your-app-with-service-objects/). You should read it.
 
@@ -21,15 +23,22 @@ Or install it yourself as:
     $ gem install services_base
 
 ## Usage
+```ruby
+class Services::MyService
+  include Services::Base
 
-    class Services::MyService
-      include ServicesBase
+  def call(id)
+    # do something
+    result_object = { foo: 'bar' }
 
-      def call(id)
-        # do something
-      end
-    end
+    # and return success
+    return Services::Responses::Success.new(result_object)
 
+    # or if there's an error:
+    return Services::Responses::Error.new(result_object, error_message: 'Something went wrong', error_code: 123)
+  end
+end
+```
 
 ## License
 

data/lib/services/base.rb

@@ -0,0 +1,22 @@
+# Significantly inspired by http://chrisholtz.com/blog/organize-your-app-with-service-objects/
+module Services
+  module Base
+    def self.included(base)
+      base.extend ClassMethods
+      base.include InstanceMethods
+    end
+
+    module ClassMethods
+      def call(*args, &block)
+        @instance ||= self.new
+        @instance.call *args, &block
+      end
+    end
+
+    module InstanceMethods
+      def call(*args, &block)
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/services/responses/base.rb

@@ -0,0 +1,20 @@
+module Services
+  module Responses
+    class Base
+      attr_reader :result
+
+      def initialize(result = nil)
+        @result = result
+      end
+
+      def success?
+        raise NotImplementedError
+      end
+
+      def error?
+        !success?
+      end
+
+    end
+  end
+end

data/lib/services/responses/error.rb

@@ -0,0 +1,15 @@
+module Services
+  module Responses
+    class Error < Services::Responses::Base
+      attr_accessor :error_message, :error_code
+
+      def initialize(result, error_message: nil, error_code: nil)
+        @result, @error_message, @error_code = result, error_message, error_code
+      end
+
+      def success?
+        false
+      end
+    end
+  end
+end

data/lib/services/responses/success.rb

@@ -0,0 +1,9 @@
+module Services
+  module Responses
+    class Success < Services::Responses::Base
+      def success?
+        true
+      end
+    end
+  end
+end

data/lib/services/version.rb

@@ -0,0 +1,3 @@
+module Services
+  VERSION = "0.2.0"
+end

data/lib/services_base.rb

@@ -1,22 +1,5 @@
-require "services_base/version"
-
-# Significantly inspired by http://chrisholtz.com/blog/organize-your-app-with-service-objects/
-module ServicesBase
-  def self.included(base)
-    base.extend ClassMethods
-    base.include InstanceMethods
-  end
-
-  module ClassMethods
-    def call(*args, &block)
-      @instance ||= self.new
-      @instance.call *args, &block
-    end
-  end
-
-  module InstanceMethods
-    def call(*args, &block)
-      raise NotImplementedError
-    end
-  end
-end
+require "services/version"
+require "services/base"
+require "services/responses/base"
+require "services/responses/error"
+require "services/responses/success"

data/services_base.gemspec

@@ -1,16 +1,16 @@
 # coding: utf-8
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'services_base/version'
+require 'services/version'
 
 Gem::Specification.new do |spec|
   spec.name          = "services_base"
-  spec.version       = ServicesBase::VERSION
+  spec.version       = Services::VERSION
   spec.authors       = ["Carl Mercier"]
   spec.email         = ["carl@varagesale.com"]
 
-  spec.summary       = %q{Simple Base module for implementing consistent Service Objects and Micro-Services in Ruby}
-  spec.description   = %q{Simple Base module for implementing consistent Service Objects and Micro-Services in Ruby}
+  spec.summary       = %q{Simple skeleton for implementing consistent Service Objects and Micro-Services in Ruby}
+  spec.description   = %q{Simple skeleton for implementing consistent Service Objects and Micro-Services in Ruby}
   spec.homepage      = "https://github.com/varagesale/services_base"
   spec.license       = "MIT"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: services_base
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Carl Mercier
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-08-01 00:00:00.000000000 Z
+date: 2016-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -80,7 +80,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Simple Base module for implementing consistent Service Objects and Micro-Services
+description: Simple skeleton for implementing consistent Service Objects and Micro-Services
   in Ruby
 email:
 - carl@varagesale.com
@@ -98,8 +98,12 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- lib/services/base.rb
+- lib/services/responses/base.rb
+- lib/services/responses/error.rb
+- lib/services/responses/success.rb
+- lib/services/version.rb
 - lib/services_base.rb
-- lib/services_base/version.rb
 - services_base.gemspec
 homepage: https://github.com/varagesale/services_base
 licenses:
@@ -124,6 +128,6 @@ rubyforge_project:
 rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
-summary: Simple Base module for implementing consistent Service Objects and Micro-Services
+summary: Simple skeleton for implementing consistent Service Objects and Micro-Services
   in Ruby
 test_files: []

data/lib/services_base/version.rb

@@ -1,3 +0,0 @@
-module ServicesBase
-  VERSION = "0.1.0"
-end