excom 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c2e0ab278ff802a81618b2db0f1549d450a96f41
+  data.tar.gz: ca066ba4969cec14ba67359d08c7eb93b01832b4
+SHA512:
+  metadata.gz: 6f6c5e50e2e88fba4387545edfd7fd28834739b2e10a44c43a71802d0e06e3a0a464e854cb0024f647be6b81b7717b871b9c63f5cccdc635977839624abfc6f8
+  data.tar.gz: 72c07a6cd427a26c6c9fd2dc342499a39af0db3aef6524b4fa41f1ab8fac4ffacb9d0962f322c9e34a28b5964615c6ad24c688b974e4e32743139045c5bcdfc1

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+.ruby-version
+.ruby-gemset

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.2.0
+before_install: gem install bundler -v 1.16.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in excom.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Artem Kuzko
+
+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,242 @@
+# Excom
+
+Flexible and highly extensible Commands (Service Objects) for business logic.
+
+[![build status](https://secure.travis-ci.org/akuzko/excom.png)](http://travis-ci.org/akuzko/excom)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'excom'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install excom
+
+## Usage
+
+General idea behind every `excom` command is simple: each command can have arguments,
+options (named arguments), and should define `run` method that is called during
+command execution. Executed command has `status` and `result`.
+
+The **very basic usage** of `Excom` commands can be shown with following example:
+
+```rb
+# app/commands/todos/update.rb
+module Todos
+  class Update < Excom::Command
+    args :todo
+    opts :params
+
+    def run
+      if todo.update(params)
+        result success: todo.as_json
+      else
+        result failure: todo.errors
+      end
+    end
+  end
+end
+
+# app/controllers/todos/controller
+class TodosController < ApplicationController
+  def update
+    command = Todos::Update.new(todo, params: todo_params)
+
+    if command.execute.success?
+      render json: todo.result
+    else
+      render json: todo.result, status: :unprocessable_entity
+    end
+  end
+end
+```
+
+However, even this basic example can be highly optimized by using Excom extensions and helper methods.
+
+### Command arguments and options
+
+Read full version on [wiki](https://github.com/akuzko/excom/wiki#instantiating-command-with-arguments-and-options).
+
+Excom commands can be initialized with _arguments_ and _options_ (named arguments). To specify list
+of available arguments and options, use `args` and `opts` class methods. All arguments and options
+are optional during command initialization. However, you cannot pass more arguments to command or
+options that were not declared with `opts` method.
+
+```rb
+class MyCommand < Excom::Command
+  args :foo
+  opts :bar
+
+  def run
+    # do something
+  end
+
+  def foo
+    super || 5
+  end
+end
+
+c1 = MyCommand.new
+c1.foo # => 5
+c1.bar # => nil
+
+c2 = c1.with_args(1).with_opts(bar: 2)
+c2.foo # => 1
+c2.bar # => 2
+```
+
+### Command Execution
+
+Read full version on [wiki](https://github.com/akuzko/excom/wiki#command-execution).
+
+At the core of each command's execution lies `run` method. You can use `status` and/or
+`result` methods to set execution status and result. If none were used, result and status
+will be set based on `run` method's return value.
+
+Example:
+
+```rb
+class MyCommand < Excom::Command
+  alias_success :ok
+  args :foo
+
+  def run
+    if foo > 2
+      result ok: foo * 2
+    else
+      result failure: -1
+    end
+  end
+end
+
+command = MyCommand.new(3)
+command.execute.success? # => true
+command.status # => :ok
+command.result # => 6
+```
+
+### Core API
+
+Please read about core API and available class and instance methods on [wiki](https://github.com/akuzko/excom/wiki#core-api)
+
+### Command Extensions (Plugins)
+
+Excom is built with extensions in mind. Even core functionality is organized in plugins that are
+used in base `Excom::Command` class. Bellow you can see a list of plugins with some description
+and examples that are shipped with `excom`:
+
+- [`:status_helpers`](https://github.com/akuzko/excom/wiki/Plugins#status-helpers) - Allows you to
+define status aliases and helper methods named after them to immediately and more explicitly assign
+both status and result at the same time:
+
+```rb
+class Todos::Update
+  use :status_helpers, success: [:ok], failure: [:unprocessable_entity]
+  args :todo, :params
+
+  def run
+    if todo.update(params)
+      ok todo.as_json
+    else
+      unprocessable_entity todo.errors
+    end
+  end
+end
+
+command = Todos::Update.(todo, todo_params)
+# in case params were valid you will have:
+command.success? # => true
+command.status # => :ok
+command.result # => {'id' => 1, ...}
+```
+
+- [`:context`](https://github.com/akuzko/excom/wiki/Plugins#context) - Allows you to set an execution
+context for a block that will be available to any command that uses this plugin via `context` method.
+
+```rb
+# application_controller.rb
+around_action :with_context
+
+def with_context
+  Excom.with_context(current_user: current_user) do
+    yield
+  end
+end
+```
+
+```rb
+class Posts::Archive < Excom::Command
+  use :context
+  args :post
+
+  def run
+    post.update(archived: true, archived_by: context[:current_user])
+  end
+end
+```
+
+- [`:sentry`](https://github.com/akuzko/excom/wiki/Plugins#sentry) - Allows you to provide Sentry classes
+for commands that use this plugin. Each Sentry class hosts logic responsible for allowing or denying
+corresponding command's execution or related checks. Much like [pundit](https://github.com/elabs/pundit)
+Policies, but more. Where pundit governs only authorization logic, Excom's Sentries can deny execution
+with any reason you find appropriate.
+
+```rb
+class Posts::Destroy < Excom::Command
+  use :context
+  use :sentry
+  args :post
+
+  def run
+    post.destroy
+  end
+end
+
+class Posts::DestroySentry < Excom::Sentry
+  delegate :post, :context, to: :command
+  deny_with :unauthorized
+
+  def execute?
+    # only author can destroy a post
+    post.author_id == context[:current_user].id
+  end
+
+  deny_with :unprocessable_entity do
+    def execute?
+      # disallow to destroy posts that are older than 1 hour
+      (post.created_at + 1.hour).past?
+    end
+  end
+end
+```
+
+- [`:assertions`](https://github.com/akuzko/excom/wiki/Plugins#assertions) - Provides `assert` method that
+can be used for different logic checks during command execution.
+
+- [`:caching`](https://github.com/akuzko/excom/wiki/Plugins#caching) - Simple plugin that will prevent
+re-execution of command if it already has been executed, and will immediately return result.
+
+- [`:rescue`](https://github.com/akuzko/excom/wiki/Plugins#rescue) - Provides `:rescue` execution option.
+If set to `true`, any error occurred during command execution will not be raised outside.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/akuzko/excom.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "excom"
+
+class Command < Excom::Command
+  use :sentry, class: 'MySentry'
+  use :assertions
+  use :caching
+
+  args :foo
+  opts :bar, :baz
+
+  alias_success :ok
+
+  def foo
+    super || 6
+  end
+
+  def run
+    result ok: foo * 2
+    assert { foo > bar }
+  end
+end
+
+class MySentry < Excom::Sentry
+  deny_with :unauthorized
+
+  def execute?
+    command.foo != 5
+  end
+
+  deny_with :unprocessable_entity do
+    def bar?
+      command.bar && command.bar > 0
+    end
+  end
+end
+
+require "pry"
+Pry.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/excom.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'excom/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "excom"
+  spec.version       = Excom::VERSION
+  spec.authors       = ["Artem Kuzko"]
+  spec.email         = ["a.kuzko@gmail.com"]
+
+  spec.summary       = %q{Flexible and highly extensible Commands (Service Objects) for business logic}
+  spec.description   = %q{Flexible and highly extensible Commands (Service Objects) for business logic}
+  spec.homepage      = "https://github.com/akuzko/excom"
+  spec.license       = "MIT"
+
+  spec.required_ruby_version = '>= 2.2.0'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rspec-its", "~> 1.2"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "pry-nav"
+end

data/lib/excom.rb

@@ -0,0 +1,10 @@
+require "excom/version"
+
+module Excom
+  autoload :Plugins, 'excom/plugins'
+  autoload :Command, 'excom/command'
+
+  extend Plugins::Context::ExcomMethods
+
+  Sentry = Plugins::Sentry::Sentinel
+end

data/lib/excom/command.rb

@@ -0,0 +1,8 @@
+module Excom
+  class Command
+    extend Excom::Plugins::Pluggable
+
+    use :executable
+    use :args
+  end
+end

data/lib/excom/plugins.rb

@@ -0,0 +1,28 @@
+module Excom
+  module Plugins
+    autoload :Pluggable, 'excom/plugins/pluggable'
+    autoload :Executable, 'excom/plugins/executable'
+    autoload :Context, 'excom/plugins/context'
+    autoload :Sentry, 'excom/plugins/sentry'
+
+    module_function
+
+    def fetch(name)
+      require("excom/plugins/#{name}") unless plugins.key?(name)
+
+      plugins[name] || fail("extension `#{name}` is not registered")
+    end
+
+    def register(name, extension, options = {})
+      if plugins.key?(name)
+        fail ArgumentError, "extension `#{name}` is already registered"
+      end
+      extension.singleton_class.send(:define_method, :excom_options) { options }
+      plugins[name] = extension
+    end
+
+    def plugins
+      @plugins ||= {}
+    end
+  end
+end

data/lib/excom/plugins/args.rb

@@ -0,0 +1,106 @@
+module Excom
+  module Plugins::Args
+    Plugins.register :args, self
+
+    def initialize(*args)
+      args, opts = resolve_args!(args)
+
+      assert_valid_args!(args)
+      assert_valid_opts!(opts)
+
+      @args = args
+      @opts = opts
+    end
+
+    def initialize_clone(*)
+      super
+      @args = @args.dup
+      @opts = @opts.dup
+    end
+
+    def with_args(*args)
+      clone.tap{ |copy| copy.args.replace(args) }
+    end
+
+    def with_opts(opts)
+      clone.tap{ |copy| copy.opts.merge!(opts) }
+    end
+
+    protected def opts
+      @opts
+    end
+
+    protected def args
+      @args
+    end
+
+    private def resolve_args!(args)
+      opts = args.last.is_a?(Hash) ? args.pop : {}
+
+      if args.length < self.class.args_list.length
+        rest = opts
+        opts = self.class.opts_list.each_with_object({}) do |key, ops|
+          ops[key] = rest[key]
+          rest.delete(key)
+        end
+
+        args.push(rest) unless rest.empty?
+      end
+
+      return args, opts
+    end
+
+    private def assert_valid_args!(actual)
+      allowed = self.class.args_list.length
+
+      if actual.length > allowed
+        fail ArgumentError, "wrong number of args (given #{actual.length}, expected 0..#{allowed})"
+      end
+    end
+
+    private def assert_valid_opts!(actual)
+      unexpected = actual.keys - self.class.opts_list
+
+      if unexpected.any?
+        fail ArgumentError, "wrong opts #{unexpected} given"
+      end
+    end
+
+    module ClassMethods
+      def inherited(command_class)
+        command_class.const_set(:ArgMethods, Module.new)
+        command_class.send(:include, command_class::ArgMethods)
+        command_class.args_list.replace args_list.dup
+        command_class.opts_list.replace opts_list.dup
+      end
+
+      def arg_methods
+        const_get(:ArgMethods)
+      end
+
+      def args(*argz)
+        args_list.concat(argz)
+
+        argz.each_with_index do |name, i|
+          arg_methods.send(:define_method, name){ @args[i] }
+        end
+      end
+
+      def opts(*optz)
+        opts_list.concat(optz)
+
+        optz.each do |name|
+          arg_methods.send(:define_method, name){ @opts[name] }
+        end
+      end
+
+      def args_list
+        @args_list ||= []
+      end
+
+      def opts_list
+        @opts_list ||= []
+      end
+    end
+  end
+end

data/lib/excom/plugins/assertions.rb

@@ -0,0 +1,13 @@
+module Excom
+  module Plugins::Assertions
+    Plugins.register :assertions, self
+
+    def assert(fail_with: self.fail_with)
+      if yield
+        status :success unless defined?(@status)
+      else
+        failure!(fail_with)
+      end
+    end
+  end
+end

data/lib/excom/plugins/caching.rb

@@ -0,0 +1,11 @@
+module Excom
+  module Plugins::Caching
+    Plugins.register :caching, self, use_with: :prepend
+
+    def execute(*)
+      return super if block_given? || !executed?
+
+      self
+    end
+  end
+end

data/lib/excom/plugins/context.rb

@@ -0,0 +1,44 @@
+module Excom
+  module Plugins::Context
+    Plugins.register :context, self
+
+    def initialize(*)
+      @local_context = {}
+      super
+    end
+
+    def initialize_clone(*)
+      @local_context = @local_context.dup
+      super
+    end
+
+    def context
+      global_context = ::Excom.context
+      global_context.respond_to?(:merge) ?
+        global_context.merge(local_context) :
+        local_context
+    end
+
+    def with_context(ctx)
+      clone.tap{ |copy| copy.local_context.merge!(ctx) }
+    end
+
+    protected def local_context
+      @local_context
+    end
+
+    module ExcomMethods
+      def with_context(ctx)
+        current, Thread.current[:excom_context] = \
+          context, context.respond_to?(:merge) ? context.merge(ctx) : ctx
+        yield
+      ensure
+        Thread.current[:excom_context] = current
+      end
+
+      def context
+        Thread.current[:excom_context] || {}
+      end
+    end
+  end
+end

data/lib/excom/plugins/executable.rb

@@ -0,0 +1,116 @@
+module Excom
+  module Plugins::Executable
+    Plugins.register :executable, self
+
+    UNDEFINED = :__EXCOM_UNDEFINED__
+    private_constant :UNDEFINED
+
+    def initialize(*)
+      @executed = false
+      super
+    end
+
+    def initialize_clone(*)
+      clear_execution_state!
+    end
+
+    def execute(*, &block)
+      clear_execution_state!
+      result = run(&block)
+      result_with(result) unless defined? @result
+      @executed = true
+
+      self
+    end
+
+    def executed?
+      @executed
+    end
+
+    private def run
+      success!
+    end
+
+    private def clear_execution_state!
+      @executed = false
+      remove_instance_variable('@result'.freeze) if defined?(@result)
+      remove_instance_variable('@status'.freeze) if defined?(@status)
+    end
+
+    def result(obj = UNDEFINED)
+      return @result if obj == UNDEFINED
+
+      case obj
+      when Hash
+        if obj.length != 1
+          fail ArgumentError, "expected 1-item status-result pair, got: #{obj.inspect}"
+        end
+
+        @status, @result = obj.first
+      else
+        result_with(obj)
+      end
+    end
+
+    private def result_with(obj)
+      @status = obj ? :success : fail_with unless defined?(@status)
+      @result = obj
+    end
+
+    def status(status = UNDEFINED)
+      return @status = status unless status == UNDEFINED
+
+      @status
+    end
+
+    def success?
+      status == :success || self.class.success_aliases.include?(status)
+    end
+
+    def failure?
+      !success?
+    end
+
+    private def success!
+      @status = :success
+      @result = true
+    end
+
+    private def failure!(status = fail_with)
+      @status = status
+    end
+
+    protected def fail_with
+      self.class.fail_with
+    end
+
+    module ClassMethods
+      def call(*args)
+        new(*args).execute
+      end
+
+      def [](*args)
+        call(*args).result
+      end
+
+      def fail_with(status = nil)
+        return @fail_with || :failure if status.nil?
+
+        @fail_with = status
+      end
+
+      def success_aliases
+        []
+      end
+
+      def alias_success(*aliases)
+        singleton_class.send(:define_method, :success_aliases) { super() + aliases }
+      end
+
+      def method_added(name)
+        private :run if name == :run
+        super if defined? super
+      end
+    end
+  end
+end

data/lib/excom/plugins/pluggable.rb

@@ -0,0 +1,20 @@
+module Excom
+  module Plugins::Pluggable
+    def use(name, **opts)
+      extension = Plugins.fetch(name)
+
+      method = extension.excom_options[:use_with] || :include
+      send(method, extension)
+
+      if extension.const_defined?('ClassMethods')
+        extend extension::ClassMethods
+      end
+
+      if extension.respond_to?(:used)
+        extension.used(self, **opts)
+      end
+
+      extension
+    end
+  end
+end

data/lib/excom/plugins/rescue.rb

@@ -0,0 +1,27 @@
+module Excom
+  module Plugins::Rescue
+    Plugins.register :rescue, self
+
+    attr_reader :error
+
+    def initialize_clone(*)
+      remove_instance_variable('@error') if defined?(@error)
+      super
+    end
+
+    def execute(**opts)
+      rezcue = opts.delete(:rescue)
+      super
+    rescue StandardError => error
+      clear_execution_state!
+      @error = error
+      @status = :error
+      raise error unless rezcue
+      self
+    end
+
+    def error?
+      status == :error
+    end
+  end
+end

data/lib/excom/plugins/sentry.rb

@@ -0,0 +1,62 @@
+module Excom
+  module Plugins::Sentry
+    autoload :Sentinel, 'excom/plugins/sentry/sentinel'
+
+    Plugins.register :sentry, self
+
+    def self.used(command_class, **opts)
+      klass = opts[:class]
+
+      command_class._sentry_class = klass if klass
+    end
+
+    def execute(*)
+      reason = why_cant(:execute)
+
+      return super if reason.nil?
+
+      failure!(reason)
+
+      self
+    end
+
+    def can?(action)
+      why_cant(action).nil?
+    end
+
+    def why_cant(action)
+      sentry.denial_reason(action)
+    end
+
+    def sentry
+      @sentry ||= self.class.sentry_class.new(self)
+    end
+
+    module ClassMethods
+      attr_writer :_sentry_class
+
+      def inherited(command_class)
+        super
+        command_class.sentry_class(_sentry_class)
+      end
+
+      def sentry_class(klass = nil)
+        return self._sentry_class = klass unless klass.nil?
+
+        if _sentry_class.is_a?(String)
+          return _sentry_class.constantize if _sentry_class.respond_to?(:constantize)
+
+          names = _sentry_class.split('::'.freeze)
+          names.shift if names.first.empty?
+          names.reduce(Object){ |obj, name| obj.const_get(name) }
+        else
+          _sentry_class
+        end
+      end
+
+      def _sentry_class
+        @_sentry_class ||= "#{name}Sentry"
+      end
+    end
+  end
+end

data/lib/excom/plugins/sentry/sentinel.rb

@@ -0,0 +1,96 @@
+module Excom
+  module Plugins::Sentry
+    class Sentinel
+      def self.deny_with(reason)
+        return self.denial_reason = reason unless block_given?
+
+        klass = Class.new(self, &Proc.new)
+        klass.denial_reason = reason
+        sentinels << klass
+      end
+
+      def self.denial_reason=(reason)
+        @denial_reason = reason
+      end
+
+      def self.denial_reason
+        @denial_reason ||= :denied
+      end
+
+      def self.allow(*actions)
+        actions.each do |name|
+          define_method("#{name}?") { true }
+        end
+      end
+
+      def self.deny(*actions, with: nil)
+        return deny_with(with){ deny(*actions) } unless with.nil?
+
+        actions.each do |name|
+          define_method("#{name}?") { false }
+        end
+      end
+
+      def self.sentinels
+        @sentinels ||= []
+      end
+
+      attr_reader :command
+
+      def initialize(command)
+        @command = command
+      end
+
+      def denial_reason(action)
+        method = "#{action}?"
+
+        reason = sentries.reduce(nil) do |result, sentry|
+          result || (sentry.class.denial_reason unless !sentry.respond_to?(method) || sentry.public_send(method))
+        end
+
+        Proc === reason ? instance_exec(&reason) : reason
+      end
+
+      def sentry(klass)
+        unless Class === klass
+          klass_name = self.class.name.sub(/[^:]+\Z/, ''.freeze) + "_#{klass}".gsub!(/(_([a-z]))/){ $2.upcase } + 'Sentry'.freeze
+          klass = klass_name.respond_to?(:constantize) ?
+            klass_name.constantize :
+            klass_name.split('::'.freeze).reduce(Object){ |obj, name| obj.const_get(name) }
+        end
+
+        klass.new(command)
+      end
+
+      def to_hash
+        sentries.reduce({}) do |result, sentry|
+          partial = sentry.public_methods(false).grep(/\?$/).each_with_object({}) do |method, hash|
+            hash[method.to_s[0...-1]] = !!sentry.public_send(method)
+          end
+
+          result.merge!(partial){ |_k, old, new| old && new }
+        end
+      end
+
+      private def sentries
+        [self] + sentinels
+      end
+
+      private def sentinels
+        @sentinels ||= self.class.sentinels.map do |klass|
+          klass.new(command)
+        end
+      end
+
+      def method_missing(name, *)
+        if name.to_s.end_with?(??)
+          sentinels[1..-1].each do |sentry|
+            return sentry.public_send(name) if sentry.respond_to?(name)
+          end
+        end
+
+        super
+      end
+    end
+  end
+end

data/lib/excom/plugins/status_helpers.rb

@@ -0,0 +1,25 @@
+module Excom
+  module Plugins::StatusHelpers
+    Plugins.register :status_helpers, self
+
+    def self.used(klass, success: [], failure: [])
+      klass.alias_success(*success)
+
+      helpers = Module.new do
+        (success + failure).each do |name|
+          define_method(name) do |result = nil|
+            @status = name
+            @result = result
+          end
+        end
+      end
+
+      klass.const_set('StatusHelpers', helpers)
+      klass.send(:include, helpers)
+    end
+
+    def success?
+      super || self.class.success_aliases.include?(status)
+    end
+  end
+end

data/lib/excom/version.rb

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

metadata

@@ -0,0 +1,153 @@
+--- !ruby/object:Gem::Specification
+name: excom
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Artem Kuzko
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-12-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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: pry-nav
+  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: Flexible and highly extensible Commands (Service Objects) for business
+  logic
+email:
+- a.kuzko@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- excom.gemspec
+- lib/excom.rb
+- lib/excom/command.rb
+- lib/excom/plugins.rb
+- lib/excom/plugins/args.rb
+- lib/excom/plugins/assertions.rb
+- lib/excom/plugins/caching.rb
+- lib/excom/plugins/context.rb
+- lib/excom/plugins/executable.rb
+- lib/excom/plugins/pluggable.rb
+- lib/excom/plugins/rescue.rb
+- lib/excom/plugins/sentry.rb
+- lib/excom/plugins/sentry/sentinel.rb
+- lib/excom/plugins/status_helpers.rb
+- lib/excom/version.rb
+homepage: https://github.com/akuzko/excom
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: Flexible and highly extensible Commands (Service Objects) for business logic
+test_files: []