service_object 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 449e4bf91c536fb0279d4120a6ab3b268c3f5c13
+  data.tar.gz: 9e9117fc1345ddb731825f6c876a00b933af9bf3
+SHA512:
+  metadata.gz: 2560a175d5fc0c6294a60b8e7e62f08bc22ee2dc3205f5b2ffd2a02bbb9394c94137790aff891a314ce314c61b40d1c491c01ccc930f246b414fb222f44f3f8f
+  data.tar.gz: 68c2148bf83ed99ff2503b399497dee84da2164a5aae1df713a688fd64fff5cfe83fe1a506563a8597ef6f9b26743994c4529ee4ef8fc2e288169c161c78b3ce

data/.rspec

@@ -0,0 +1,2 @@
+--format=doc
+--color

data/.travis.yml

@@ -0,0 +1,20 @@
+language: ruby
+rvm:
+  - 2.2.2
+  - 2.3.4
+  - 2.4.1
+
+gemfile:
+  - gemfiles/4.0.gemfile
+  - gemfiles/4.1.gemfile
+  - gemfiles/4.2.gemfile
+  - gemfiles/5.0.gemfile
+  - gemfiles/5.1.gemfile
+
+matrix:
+  fast_finish: true
+  allow_failures:
+    - rvm: ruby-head
+
+sudo: false
+cache: bundler

data/Appraisals

@@ -0,0 +1,19 @@
+appraise "4.0" do
+  gem "rails", "~> 4.0.0"
+end
+
+appraise "4.1" do
+  gem "rails", "~> 4.1.0"
+end
+
+appraise "4.2" do
+  gem "rails", "~> 4.2.0"
+end
+
+appraise "5.0" do
+  gem "rails", "~> 5.0.0"
+end
+
+appraise "5.1" do
+  gem "rails", "~> 5.1.0"
+end

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+gemspec
+

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2014- Yukio Mizuta
+
+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,205 @@
+# ServiceObject for Ruby on Rails
+
+A mini gem to make it easy for you to have service objects in Rails.
+
+This gem allows your controllers to control only flows and encapsulates detailed logic in services.
+
+```ruby
+  def some_action_on_book
+    service = CreateMyBookService.new(params[:isbn])
+    service.run do |s|
+      s.get_info_from_isbn_api
+      s.get_availability_with_library
+      s.save_my_book
+    end
+    if service.result
+      render json: { result: 'success', message: 'Successfully saved the book data' }
+    else
+      render json: { result: 'failure', messages: service.error_messages }
+    end
+  end
+```
+
+[Rails Cast (Pro): #398 Service Objects](http://railscasts.com/episodes/398-service-objects)
+
+[![Code Climate](https://codeclimate.com/github/untidy-hair/service_object/badges/gpa.svg)](https://codeclimate.com/github/untidy-hair/service_object)
+[![Build Status](https://travis-ci.org/untidy-hair/service_object.svg?branch=ci-setup)](https://travis-ci.org/untidy-hair/service_object)
+
+## Install
+In your Rails application Gemfile, add this line and do 'bundle install'
+```ruby
+gem 'service_object'
+```
+
+## Usage (What you need to know)
+1. How to implement your code
+  - Inherit ServiceObject::Base in your service class.
+  - Your service class needs to call `super` in its initializer for now.
+  - Define your methods in the service.
+  - Make your service method raise an error whenever it fails. 
+  (By default, ServiceObject::Base\#result will return false and ServiceObject::Base\#error_messages will have error message.)
+  - For error cases, override and customize ServiceObject::Base\#process_exception(e) to handle exceptions in your own way. 
+  As a best practice, process only expected errors but re-raise unexpected errors. (See Sample 2 below)
+  By default, all `StandardError` will be caught and the error messages will be stored in `@errors` that thus will be accessible through `#error_messages`.
+  - Implement your controller with `run` or `execute` method and put your service methods inside the block.
+
+2. Interfaces for controllers
+  - ServiceObject::Base\#run(#execute): Put your service methods in order in the \#run block. (See samples below.)
+  - ServiceObject::Base\#result: If all the service process goes well, it returns true.
+Otherwise it returns false.
+  - ServiceObject::Base\#error_messages: Returns an array of error messages.
+
+3. Other utility methods
+  - ServiceObject::Base\#logger is available (delegated to Rails.logger)
+  - ServiceObject::Base\#transaction is available (delegated to ActiveRecord::Base.transaction)
+  - ServiceObject::Base\#flattened_active_model_error(private) changes ActiveModel error
+to a string so that the error gets easy to add to `@errors`
+
+
+## Sample 1
+
+### Controller
+Your controller will be well-readable and the flow is easy to understand.
+You can use \#result or \#error_messages to know the result of your service.
+
+```ruby
+  def some_action_on_book
+    service = CreateMyBookService.new(params[:isbn])
+    service.run do |s|
+      s.get_info_from_isbn_api
+      s.get_availability_with_library
+      s.save_my_book
+    end
+    if service.result
+      render json: { result: 'success', message: 'Successfully saved the book data' }
+    else
+      render json: { result: 'failure', messages: service.error_messages }
+    end
+  end
+```
+
+### Service
+Inherit ServiceObject::Base and implement business logic into methods.
+When something goes wrong, throw an error from inside your method in service.
+The process stops there and the error will be added to service.errors (available through service.error_messages) and service.result returns false automatically.
+```ruby
+class CreateMyBookService < ServiceObject::Base
+  def initialize(isbn)
+    super # This is necessary
+    @isbn = isbn
+    @book_info = nil
+    @my_book = MyBook.new # ActiveRecord Model
+    @isbn_api = IsbnApi.new(@isbn) # Non-AR Model
+    @library_api = LibraryApi.new # Non-AR Model
+  end
+
+  def get_info_from_isbn_api
+    @book_info = @isbn_api.get_all_info
+  end
+
+  def get_availability_with_library
+    @availability = @library_api.get_availability(@isbn)
+  rescue Net::HTTPError => e
+    # You can re-throw you own error, too.
+    raise YourError, 'Failed to get availability from library'
+  end
+
+  def save_my_book
+    @my_book.update!(
+      available: @availability,
+      name: @book_info.title,
+      author: @book_info.author,
+      isbn: @isbn
+     )
+  end
+end
+```
+
+## Sample 2
+
+A sample with DB transaction and rollback process.
+
+### Controller
+```ruby
+  def some_action_on_content_file
+    service = UploadContentService.new(content_params, session[:user_id])
+    service.execute do |s| # execute is alias of #run
+      s.upload_file
+      s.transaction do
+        s.save_content_data
+        s.update_user
+      end
+    end
+
+    if service.executed_successfully? # executed_successfully is alias of #result
+      render json: { result: 'success', message: 'Successfully uploaded your content' }
+    else
+      render json: { result: 'failure', messages: service.error_messages }
+    end
+  end
+```
+
+### Service
+
+```ruby
+class UploadContentService < ServiceObject::Base
+  def initialize(params, user_id)
+    super
+    @content = Content.new(params)
+    @file = ContentFile.new(params[:file_path])
+    @user = User.find(user_id)
+  end
+
+  def upload_file
+    raise YourFileError, "File Type needs to be one of #{ContentFile::TYPES.join('/')}" unless @file.allowed_file_type?
+    @file.build_permission_info
+    @file.queue_upload_job! # Let's assume this throws ContentFile::YourOwnEnqueueError when failing.
+  end
+
+  def save_content_data
+    @content.update!(active: true)
+  end
+
+  def update_user
+    @user.contents_counter += 1 # This is just a contrived sample. Use counter_cache
+    @user.save!
+  end
+
+  # Custom error process by overriding the originally defined #process_exception.
+  def process_exception(e)
+    if e.is_a? ActiveRecord::ActiveRecordError 
+      # When DB persistence fails, revert uploading file, too.
+      rollback_uploaded_file
+      @errors.add flattened_active_model_error(e.record) # This method is provided for convenience
+    elsif e.class.in? [ContentFile::YourOwnEnqueueError, YourFileError]
+      # This is still known error.
+      logger.warn 'File upload had an issue.'
+      @errors.add e.message
+    else
+      # Other errors are unexpected, so let the system fail by re-raising the error. 
+      raise e  
+    end
+  end
+  
+  def rollback_uploaded_file
+    if @file.respond_to?(:queued?) && @file.queued?
+      @file.delete_queue_job
+    end
+  end
+end
+```
+
+## More Flow Controls (hooks)
+- Override `before_run` method if there are pre-processes that you don't want to show in your controller.
+- Override `after_run` method if there are post-processes that you don't want to show in your controller.
+
+## To Do
+- Integration tests / Tests for each use case
+
+## Credits
+
+ServiceObject is written by untidyhair(Yukio Mizuta).
+
+## License
+
+[MIT-LICENSE](MIT-LICENSE)

data/Rakefile

@@ -0,0 +1,15 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task default: :spec

data/gemfiles/4.0.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 4.0.0"
+
+gemspec :path => "../"

data/gemfiles/4.1.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 4.1.0"
+
+gemspec :path => "../"

data/gemfiles/4.2.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 4.2.0"
+
+gemspec :path => "../"

data/gemfiles/5.0.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 5.0.0"
+
+gemspec :path => "../"

data/gemfiles/5.1.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 5.1.0"
+
+gemspec :path => "../"

data/lib/service_object.rb

@@ -0,0 +1,2 @@
+require 'service_object/base'
+require 'service_object/errors'

data/lib/service_object/base.rb

@@ -0,0 +1,129 @@
+require 'active_support/core_ext/module/delegation'
+module ServiceObject
+  # Service object base class which provides interfaces to controllers so that
+  # they can access the result of service processing and its errors if any.
+  # Uses ServiceObject::Errors as the error container.
+  class Base
+    # @return [ServiceObject::Errors] Errors object of the current service
+    attr_reader :errors
+    delegate :logger, to: :Rails
+
+    def initialize(*args)
+      @result = true
+      @errors = Errors.new
+    end
+
+    # This runs your logic without exposing unessential processes to your controllers.
+    # @return [true, false]
+    #
+    # Examples:
+    # # Controller
+    #  def some_action_on_book
+    #    service = CreateMyBookService.new(params[:isbn])
+    #    service.run do |s|
+    #      s.get_info_from_isbn_api
+    #      s.get_availability_with_library
+    #      s.save_my_book
+    #    end
+    #    if service.result
+    #      render json: { result: 'success', message: 'Successfully saved the book data' }
+    #    else
+    #      render json: { result: 'failure', messages: service.error_messages }
+    #    end
+    #  end
+    #
+    # # Service
+    # class CreateMyBookService < ServiceObject::Base
+    #   def initialize(isbn)
+    #     super # This is necessary
+    #     @isbn = isbn
+    #     @book_info = nil
+    #     @my_book = MyBook.new # ActiveRecord Model
+    #     @isbn_api = IsbnApi.new(@isbn) # Non-AR Model
+    #     @library_api = LibraryApi.new # Non-AR Model
+    #   end
+    #
+    #   def get_info_from_isbn_api
+    #     @book_info = @isbn_api.get_all_info
+    #   end
+    #
+    #   def get_availability_with_library
+    #     @availability = @library_api.get_availability(@isbn)
+    #   rescue Net::HTTPError => e
+    #     # You can re-throw you own error, too.
+    #     raise YourError, 'Failed to get availability from library'
+    #   end
+    #
+    #   def save_my_book
+    #     @my_book.update!(
+    #         available: @availability,
+    #         name: @book_info.title,
+    #         author: @book_info.author,
+    #         isbn: @isbn
+    #    )
+    #   end
+    # end
+    #
+    def run
+      before_run
+      yield self
+      after_run
+      @result
+    rescue => e
+      process_exception(e)
+      @result = false
+    end
+    alias execute run
+
+    # Error messages of the service process so far
+    # @return [Array] Array of error messages
+    def error_messages
+      @errors.full_messages
+    end
+
+    # Check if the service process is going well or not so far
+    # @return [true, false]
+    def result
+      @result && @errors.empty?
+    end
+    alias executed_successfully? result
+    alias ran_successfully? result
+
+    # Shorthand for ActiveRecord::Base.transaction
+    def transaction(&block)
+      self.class.transaction(&block)
+    end
+
+    class << self
+
+      # Shorthand for ActiveRecord::Base.transaction
+      def transaction(&block)
+        ActiveRecord::Base.transaction(&block)
+      end
+    end
+
+    private
+
+    # Override this method when there are other pre-processes that you don't want to show in controller.
+    def before_run; end
+
+    # Override this method when there are other post-processes that you don't want to show in controller.
+    def after_run; end
+
+    # @param e [StandardError]
+    # This puts all StandardError encountered into @errors, which will be available through #error_messages.
+    # If you want to specify special behaviors for each error type such as some rollback process or error logging,
+    # please override this method. (See README.md Sample 2.)
+    def process_exception(e)
+      @errors.add "#{e.class}: #{e.message}"
+    end
+
+    # Change activemodel errors into a string to be added to service errors
+    # @param active_model [ActiveModel] ActiveModel Object
+    #   whose error messages are to be flattened
+    # @return [String] Flattened string error message
+    def flattened_active_model_error(active_model)
+      "#{active_model.class}: #{active_model.errors.full_messages.join(', ')}"
+    end
+  end
+end

data/lib/service_object/errors.rb

@@ -0,0 +1,72 @@
+require 'active_support/core_ext/array/conversions'
+require 'delegate'
+
+module ServiceObject
+
+  # Provides a customized +Array+ to contain errors that happen in service layer.
+  # Also provides a utility APIs to handle errors well in controllers.
+  # (All array methods are available by delegation, too.)
+  #   errs = ServiceObject::Errors.new
+  #   errs.add 'Something is wrong.'
+  #   errs.add 'Another is wrong.'
+  #   errs.messages
+  #   => ['Something is wrong.','Another is wrong.']
+  #   errs.full_messages
+  #   => ['Something is wrong.','Another is wrong.']
+  #   errs.to_xml
+  #   => "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<errors>\n  <error>Something is wrong.</error>\n
+  #  <error>Another is wrong.</error>\n</errors>\n"
+  #   errs.empty?
+  #   => false
+  #   errs.clear
+  #   => []
+  #   errs.empty?
+  #   => true
+  class Errors < Delegator
+    # @return [Array<String>] Messages of the current errors
+    attr_reader :messages
+
+    def initialize
+      @messages = []
+    end
+
+    # @private
+    def __getobj__ # :nodoc:
+      @messages
+    end
+
+    # Returns all the current error messages
+    # @return [Array<String>] Messages of the current errors
+    def full_messages
+      messages
+    end
+
+    # Adds a new error message to the current error messages
+    # @param message [String] New error message to add
+    def add(message)
+      @messages << message
+    end
+
+    # Generates XML format errors
+    #   errs = ServiceObject::Errors.new
+    #   errs.add 'Something is wrong.'
+    #   errs.add 'Another is wrong.'
+    #   errs.to_xml
+    #   =>
+    #   <?xml version=\"1.0\" encoding=\"UTF-8\"?>
+    #    <errors>
+    #      <error>Something is wrong.</error>
+    #      <error>Another is wrong.</error>
+    #    </errors>
+    # @return [String] XML format string
+    def to_xml(options={})
+      super({ root: "errors", skip_types: true }.merge!(options))
+    end
+
+    # Generates duplication of the message
+    # @return [Array<String>]
+    def as_json
+      messages.dup
+    end
+  end
+end

data/lib/service_object/version.rb

@@ -0,0 +1,3 @@
+module ServiceObject
+  VERSION = "0.1.2"
+end

data/lib/tasks/service_object_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :service_object do
+#   # Task goes here
+# end

data/service_object.gemspec

@@ -0,0 +1,24 @@
+$:.push File.expand_path('../lib', __FILE__)
+
+require 'service_object/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'service_object'
+  s.version     = ServiceObject::VERSION
+  s.authors     = ['Yukio Mizuta']
+  s.email       = ['untidyhair@gmail.com']
+  s.homepage    = ''
+  s.summary     = 'Small but powerful service objects/service layers library for Rails application.'
+  s.description = 'Not only does it let you code complicated business logic easier, but it also helps you keep controllers well-readable and models loose-coupled to each other.'
+  s.license     = 'MIT'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'rails', '>= 4.0.0'
+  s.add_development_dependency 'pry-rails'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'appraisal'
+end

data/spec/service_object/base_spec.rb

@@ -0,0 +1,77 @@
+require 'spec_helper'
+
+class DummyService < ServiceObject::Base; end
+
+describe ServiceObject::Base do
+  subject { DummyService.new }
+
+  specify 'The errors attribute is a ServiceObject::Errors instance' do
+    expect(subject.errors).to be_a ServiceObject::Errors
+  end
+
+  specify 'The result attribute is set as true after instantiation' do
+    expect(subject.result).to be true
+  end
+
+  describe '#error_messages' do
+    it 'returns @errors full_messages' do
+      expect(subject.error_messages).to eq subject.errors.full_messages
+      subject.errors.add 'Error Message 1'
+      expect(subject.error_messages).to eq subject.errors.full_messages
+      subject.errors.add 'Error Message 2'
+      expect(subject.error_messages).to eq subject.errors.full_messages
+    end
+  end
+
+  describe '#result' do
+    context 'When @result is true and @errors are empty' do
+      it 'returns true' do
+        expect(subject.result).to be true
+      end
+    end
+
+    context 'When @result is false' do
+      it 'returns false' do
+        subject.instance_variable_set(:@result, false)
+        expect(subject.result).to be false
+      end
+    end
+
+    context 'When @result is true but @errors are not empty' do
+      it 'returns false' do
+        subject.errors.add 'Error added!'
+        expect(subject.result).to be false
+      end
+    end
+  end
+
+  describe '-#flattened_active_model_error' do
+    it 'returns error info of given active model instance as string' do
+      class DummyActiveModel
+        include ActiveModel::Model
+        attr_reader :name, :age
+        validates :name, presence: true
+        validates :age, numericality: { only_integer: true }
+      end
+      dummy_model = DummyActiveModel.new
+      dummy_model.valid?
+      expect(subject.__send__(:flattened_active_model_error, dummy_model)).
+        to eq 'DummyActiveModel: Name can\'t be blank, Age is not a number'
+    end
+  end
+
+  # ToDo: How to expect messages with a block
+  describe '.transaction' do
+    it 'delegates to ActiveRecord::Base.transaction' do
+      expect(ActiveRecord::Base).to receive(:transaction)
+      described_class.transaction { 'hoge' }
+    end
+  end
+
+  describe '#transaction' do
+    it 'delegates to .transaction' do
+      expect(described_class).to receive(:transaction)
+      subject.transaction { 'hoge' }
+    end
+  end
+end

data/spec/service_object/errors_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+describe ServiceObject::Errors do
+  # This example is not comprehensive
+  it 'delegates to @messages' do
+    messages = subject.messages
+    [:unshift, :push, :<<].each do |method|
+      expect(messages).to receive(method).with(100)
+      subject.__send__(method, 100)
+    end
+  end
+
+  describe '#add' do
+    it 'adds new error(s) to @messages' do
+      subject.add 'Error 1'
+      expect(subject.messages).to eq ['Error 1']
+      subject.add 'Error 2'
+      expect(subject.messages).to eq ['Error 1', 'Error 2']
+    end
+  end
+
+  describe '#full_message' do
+    it 'returns the same value as @messages' do
+      subject.add 'Error 1'
+      expect(subject.full_messages).to eq subject.messages
+      subject.add 'Error 2'
+      expect(subject.full_messages).to eq subject.messages
+    end
+  end
+
+  describe '#to_xml' do
+    it 'returns a xml format string' do
+      subject.add 'Something went wrong.'
+      subject.add 'Another error happened.'
+      expect(subject.to_xml).to eq <<-XML
+<?xml version=\"1.0\" encoding=\"UTF-8\"?>
+<errors>
+  <error>Something went wrong.</error>
+  <error>Another error happened.</error>
+</errors>
+      XML
+    end
+  end
+
+  describe '#as_json' do
+    before { subject.add 'Test error happened' }
+    it 'returns messages as an Array' do
+      expect(subject.as_json).to eq subject.messages
+      expect(subject.as_json).to be_a Array
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'rails/all'
+require 'service_object'
+
+# Read support files if any
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
+
+RSpec.configure do |config|
+  config.before(:suite) do
+    I18n.enforce_available_locales = false
+  end
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: service_object
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- Yukio Mizuta
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-04-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+- !ruby/object:Gem::Dependency
+  name: pry-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Not only does it let you code complicated business logic easier, but
+  it also helps you keep controllers well-readable and models loose-coupled to each
+  other.
+email:
+- untidyhair@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".travis.yml"
+- Appraisals
+- Gemfile
+- MIT-LICENSE
+- README.md
+- Rakefile
+- gemfiles/4.0.gemfile
+- gemfiles/4.1.gemfile
+- gemfiles/4.2.gemfile
+- gemfiles/5.0.gemfile
+- gemfiles/5.1.gemfile
+- lib/service_object.rb
+- lib/service_object/base.rb
+- lib/service_object/errors.rb
+- lib/service_object/version.rb
+- lib/tasks/service_object_tasks.rake
+- service_object.gemspec
+- spec/service_object/base_spec.rb
+- spec/service_object/errors_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.12
+signing_key: 
+specification_version: 4
+summary: Small but powerful service objects/service layers library for Rails application.
+test_files:
+- spec/service_object/base_spec.rb
+- spec/service_object/errors_spec.rb
+- spec/spec_helper.rb