commande 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9138bf2b694ca329c484c5ae02d2ee885cf2810e
+  data.tar.gz: 608cad9501f9cc6722e513721fced30061bf1bc0
+SHA512:
+  metadata.gz: 79731f5f849e680b495a7b38a6d185b719a0985205a38079a6829ec50b3c353299e2be367350be40e37fc1fcaafbcd6af76888d757cbb7f01cdfb98cdc9b8fa9
+  data.tar.gz: 8263d5a510b6f5151f9ed895912f29009f5b6e06d79386bea942a61758f857fa28fe4066be0183679fc7ab98dfcb11f26c3e43dd8e7c1a58162462ff1637c711

data/.gitignore

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

data/.rubocop.yml

@@ -0,0 +1,11 @@
+AllCops:
+  Include:
+    - '**/Rakefile'
+    - 'lib/**/*.rb'
+  Exclude:
+    - 'Gemfile'
+    - 'bin/**/*'
+  TargetRubyVersion: 2.3
+
+Style/EndOfLine:
+  EnforcedStyle: lf

data/.travis.yml

@@ -0,0 +1,20 @@
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.3.0
+  - 2.4
+  - 2.5
+  - 2.6
+  - rbx-3
+  - ruby-head
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: rbx-3
+    - rvm: 2.6
+before_install:
+  - gem update --system
+  - gem --version
+install:
+  - bundle install --with development --jobs=3 --retry=3 --path=${BUNDLE_PATH:-vendor/bundle}

data/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.3.0
+- Naming gem as `commande`.
+- Github require continues to work because `command` can be required.
+- Aliases using `command/**` for all `commande/**`
+
+## 0.2.1
+
+- `assert_valid` and `refute_valid` take `*args`, to match `Command#call` (and thus `Command#valid?`)

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at derk-jan+github@karrenbeld.info. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in command.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Derk-Jan Karrenbeld
+
+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,115 @@
+# Command
+[![Build Status: master](https://travis-ci.com/SleeplessByte/command.svg?branch=master)](https://travis-ci.com/SleeplessByte/command)
+[![Gem Version](https://badge.fury.io/rb/commande.svg)](https://badge.fury.io/rb/commande)
+[![MIT license](http://img.shields.io/badge/license-MIT-brightgreen.svg)](http://opensource.org/licenses/MIT)
+
+Command adds the [Command Design Pattern](https://sourcemaking.com/design_patterns/command) to any `Class`. 
+
+This was based on `Hanami::Interactor`, and started off as adding a direct `call` on the singleton class, before that
+was added to Hanami's. After working with different interactors and command-style gems, including ways to organize
+units for execution and without depending on other utility classes, `command` was born.
+
+Because [`command`](https://rubygems.org/gems/command) has been taken on rubygems (but not updated since 2013), and
+[`commando`](https://rubygems.org/gems/commando) has been taken (but not updated since 2009) and the Dutch `opdracht` is
+probably not pronounceable by most people using this, I've decided to register this on the French 
+[`commande`](https://rubygems.org/gems/commande).
+
+However, if you are using this directly from GitHub, you can continue using it as is, without renaming, as long as you
+change the Gemfile line to `require: 'command'`.
+
+```Ruby
+# Gemfile
+gem 'commande', require: 'command'
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```Ruby
+gem 'commande'
+```
+
+or alternatively if you would like to refer to commande as `Command`:
+
+```Ruby
+gem 'commande', require: 'command'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install commande
+
+## Usage
+
+There are examples in the code and the tests. Here is a crude and basic example:
+
+```Ruby
+class FetchSecondInput
+  include Commande
+  
+  output :fetched
+  
+  def call(*args)
+    # always define call
+    self.fetched = args.second 
+  end
+  
+  def valid?(*args)
+    args.length == 2
+  end
+  
+  private
+  
+  attr_accessor :fetched
+end
+
+result = FetchSecondInput.call(42, 'gem')
+result.successful? # => true
+result.fetched # => 'gem'
+
+result = FetchSecondInput.call(42, 'gem', 'three is a crowd')
+result.successful? # => false
+result.fetched # => nil
+```
+
+## Testing
+
+There are some `Minitest` assertions included in this library.
+
+```Ruby
+require 'commande/minitest'
+```
+| Assert | Refute | |
+|:---:|:---:|:---:|
+| `assert_successful(command_result)` | `refute_successful` | passes if the command is successful?
+| `assert_valid(command, *args_for_valid)` | `refute_valid` | passes if the command is valid
+| `assert_with_error(expected, actual)` | `refute_with_error` | passes if the command has a certain error message
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. 
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the 
+version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, 
+push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at [SleeplessByte/commmand](https://github.com/SleeplessByte/command).
+This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to
+the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Shrine::ConfigurableStorage project’s codebases, issue trackers, chat rooms and mailing
+lists is expected to follow the [code of conduct](https://github.com/SleeplessByte/command/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task default: :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'commande'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

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/commande.gemspec

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'commande/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'commande'
+  spec.version       = Commande::VERSION
+  spec.authors       = ['Derk-Jan Karrenbeld']
+  spec.email         = ['derk-jan+github@karrenbeld.info']
+
+  spec.summary       = 'Allows for Command pattern style POROs'
+  spec.license       = 'MIT'
+
+  spec.metadata = {
+    'bug_tracker_uri'   => 'https://github.com/SleeplessByte/command/issues',
+    'changelog_uri'     => 'https://github.com/SleeplessByte/command/CHANGELOG.md',
+    'homepage_uri'      => 'https://github.com/SleeplessByte/command',
+    'source_code_uri'   => 'https://github.com/SleeplessByte/command'
+  }
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    # spec.metadata['allowed_push_host'] = 'https://gems.sleeplessbyte.technology'
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against ' \
+      'public gem pushes.'
+  end
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'minitest', '~> 5.0'
+  spec.add_development_dependency 'rake', '~> 10.0'
+end

data/lib/command.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require 'commande'
+
+# noinspection RubyConstantNamingConvention
+Command = Commande

data/lib/command/minitest.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'command/minitest/assertions/assert_successful'
+require 'command/minitest/assertions/assert_valid'
+require 'command/minitest/assertions/assert_with_error'

data/lib/command/minitest/assertions/assert_successful.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require 'commande/minitest/assertions/assert_successful'

data/lib/command/minitest/assertions/assert_valid.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require 'commande/minitest/assertions/assert_valid'

data/lib/command/minitest/assertions/assert_with_error.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'commande/minitest/assertions/assert_with_error'
+

data/lib/commande.rb

@@ -0,0 +1,438 @@
+# frozen_string_literal: true
+
+require 'commande/version'
+
+module Commande
+  class Result < BasicObject
+    # Concrete methods
+    #
+    # @api private
+    #
+    # @see Commande::Result#respond_to_missing?
+    METHODS = ::Hash[initialize:  true,
+                     successful?: true,
+                     failure?:    true,
+                     fail!:       true,
+                     prepare!:    true,
+                     errors:      true,
+                     error:       true,
+                     logs:        true,
+                     payload:     true].freeze
+
+    # Initialize a new result
+    #
+    # @param payload [Hash] a payload to carry on
+    #
+    # @return [Commande::Result]
+    #
+    # @api private
+    def initialize(payload = {})
+      @payload = payload
+      @errors  = []
+      @logs = []
+      @success = true
+    end
+
+    # Check if the current status is successful
+    #
+    # @return [TrueClass,FalseClass] the result of the check
+    def successful?
+      @success && errors.empty?
+    end
+
+    # Check if the current status is not successful
+    #
+    # @return [TrueClass,FalseClass] the result of the check
+    def failure?
+      !successful?
+    end
+
+    # Force the status to be a failure
+    def fail!
+      @success = false
+    end
+
+    # Returns all the errors collected during an operation
+    #
+    # @return [Array] the errors
+    #
+    # @see Commande::Result#error
+    # @see Commande#call
+    # @see Commande#error
+    # @see Commande#error!
+    def errors
+      @errors.dup
+    end
+
+    # @api private
+    def add_error(*errors)
+      @errors << errors
+      @errors.flatten!
+      nil
+    end
+
+    # Returns the first errors collected during an operation
+    #
+    # @return [nil,String] the error, if present
+    #
+    #
+    # @see Commande::Result#errors
+    # @see Commande#call
+    # @see Commande#error
+    # @see Commande#error!
+    def error
+      errors.first
+    end
+
+    # Returns all the logs collected during an operation
+    #
+    # @return [Array] the errors
+    #
+    # @see Commande::Result#log
+    # @see Commande#call
+    def logs
+      @logs.dup
+    end
+
+    # @api private
+    def add_log(*logs)
+      @logs << logs
+      @logs.flatten!
+      nil
+    end
+
+    # Prepare the result before to be returned
+    #
+    # @param payload [Hash] an updated payload
+    #
+    # @api private
+    def prepare!(payload)
+      @payload.merge!(payload)
+      self
+    end
+
+    def payload
+      @payload.dup
+    end
+
+    # Return the class for debugging purposes.
+    #
+    # @see http://ruby-doc.org/core/Object.html#method-i-class
+    def class
+      (class << self; self; end).superclass
+    end
+
+    # Bare minimum inspect for debugging purposes.
+    #
+    # @return [String] the inspect string
+    #
+    #
+    # @see http://ruby-doc.org/core/Object.html#method-i-inspect
+    #
+    def inspect
+      "#<#{self.class}:#{::Kernel.format('0x0000%<id>x', id: (__id__ << 1))}#{__inspect}>"
+    end
+
+    # Alias for __id__
+    #
+    # @return [Fixnum] the object id
+    #
+    # @see http://ruby-doc.org/core/Object.html#method-i-object_id
+    def object_id
+      __id__
+    end
+
+    # Returns true if responds to the given method.
+    #
+    # @return [TrueClass,FalseClass] the result of the check
+    #
+    # @see http://ruby-doc.org/core-2.2.1/Object.html#method-i-respond_to-3F
+    def respond_to?(method_name, include_all = false)
+      respond_to_missing?(method_name, include_all)
+    end
+
+    protected
+
+    # @api private
+    def method_missing(method_name, *)
+      @payload.fetch(method_name) { super }
+    end
+
+    # @api private
+    def respond_to_missing?(method_name, _include_all)
+      method_name = method_name.to_sym
+      METHODS[method_name] || @payload.key?(method_name)
+    end
+
+    # @api private
+    def __inspect
+      " @success=#{@success} @payload=#{@payload.inspect}"
+    end
+  end
+
+  # Override for <tt>Module#included</tt>.
+  #
+  # @api private
+  def self.included(base)
+    super
+
+    base.class_eval do
+      extend ClassMethods
+    end
+  end
+
+  # Commande interface
+  # @since 1.1.0
+  module Interface
+    # Triggers the operation and return a result.
+    #
+    # All the instance variables marked as output will be available in the result.
+    #
+    # @return [Commande::Result] the result of the operation
+    #
+    # @raise [NoMethodError] if this isn't implemented by the including class.
+    #
+    # @example Expose instance variables in result payload as output
+    #
+    #   class Purchase
+    #     include Commande
+    #     output :buyer, :product, :transaction
+    #
+    #     def call(buyer:, product_code:)
+    #       @product = Product.find_by(product_code: product_code)
+    #       @buyer = Buyer.find_by(email: buyer)
+    #       @transaction = Transaction.create(buyer: @buyer, product: @product)
+    #     end
+    #   end
+    #
+    #   result = Purchase.new.call(buyer: 'john@smith.com', product_code: 'i23af')
+    #   result.failure? # => false
+    #   result.successful? # => true
+    #
+    #   result.product  # => #<Product product_code: i23af>
+    #   result.buyer    # => #<Buyer email: john@smith.com>
+    #   result.foo      # => raises NoMethodError
+    #
+    def call(*args, &block)
+      @__result = ::Commande::Result.new
+      _call(*args) { super(*args, &block) }
+    end
+
+    private
+
+    # @api private
+    def _call(*args)
+      catch :end do
+        catch :fail do
+          validate!(*args)
+          yield
+        end
+      end
+
+      _prepare!
+    end
+
+    # @since 1.1.0
+    def validate!(*args)
+      fail! unless valid?(*args)
+    end
+  end
+
+  private
+
+  # Check if proceed with <tt>#call</tt> invocation.
+  # By default it returns <tt>true</tt>.
+  #
+  # Developers can override it.
+  #
+  # @return [TrueClass,FalseClass] the result of the check
+  #
+  def valid?(*)
+    true
+  end
+
+  # Fail and interrupt the current flow.
+  #
+  def fail!
+    @__result.fail!
+    throw :fail
+  end
+
+  # Interrupt the current flow without failure
+  #
+  def end!
+    throw :end
+  end
+
+  # Log an error without interrupting the flow.
+  #
+  # When used, the returned result won't be successful.
+  #
+  # @param message [String] the error message
+  #
+  # @return false
+  #
+  #
+  # @see Commande#error!
+  #
+  def error(message)
+    @__result.add_error message
+    false
+  end
+
+  # Log an error AND interrupting the flow.
+  #
+  # When used, the returned result won't be successful.
+  #
+  # @param message [String] the error message
+  #
+  # @see Commande#error
+  #
+  def error!(message)
+    error(message)
+    fail!
+  end
+
+  # Persist a log message
+  #
+  # @param message [String] the log message
+  #
+  # @return true
+  #
+  # @see Commande#error
+  #
+  def log(message)
+    @__result.add_log(message)
+    true
+  end
+
+  protected
+
+  ##
+  # Copies errors and logs from sources and prefixes with a header:
+  #
+  # @param [Commande::Result, ApplicationRecord] source
+  # @param [String] header
+  # @return [TrueClass, FalseClass] true if successful, false otherwise
+  #
+  def transfer(source, header: nil)
+    transfer_logs(source, header: header)
+    transfer_outputs(source)
+    transfer_errors(source, header: header)
+
+    transfer_success?(source)
+  end
+
+  def transfer_logs(source, header: nil)
+    return unless source.respond_to?(:logs)
+    Array(source.logs).each do |l|
+      log header ? ::Kernel.format('%<header>s: %<log>s', header: header, log: l) : l
+    end
+  end
+
+  def transfer_outputs(source)
+    return unless source.respond_to?(:payload)
+    # Copy into current output
+    @__result.prepare!(source.payload)
+
+    # Copy into current commande
+    source.payload.each do |name, value|
+      setter = :"#{name}="
+      if respond_to?(setter, true)
+        __send__(setter, value)
+        next
+      end
+
+      ivar = :"@#{name}"
+      next unless instance_variable_defined?(ivar)
+      instance_variable_set(ivar, value)
+    end
+  end
+
+  ##
+  # Checks the success of source and returns it
+  #
+  # @param [Commande::Result, ActiveRecord::Base] source
+  # @return [TrueClass, FalseClass]
+  #
+  def transfer_success?(source)
+    return source.successful? if source.respond_to?(:successful?)
+    source.valid? && source.persisted?
+  end
+
+  def transfer_errors(source, header:)
+    errors = source.errors
+    errors = source.errors.full_messages if errors.respond_to?(:full_messages)
+    Array(errors).each do |e|
+      error header ? ::Kernel.format('%<header>s: %<error>s', header: header, error: e) : e
+    end
+
+    errors&.length&.positive?
+  end
+
+  ##
+  # Copies the status of an interactor or active record object, #fail! if not successful
+  #
+  # ATTENTION: your setter needs to be PUBLIC to be copied to.
+  #
+  # @param [Commande::Result, ApplicationRecord] source
+  # @see #transfer
+  # @see Commande
+  #
+  def transfer!(source, header: nil)
+    return if transfer(source, header: header)
+    fail!
+  end
+
+  # @api private
+  def _prepare!
+    @__result.prepare!(_outputs)
+  end
+
+  # @api private
+  def _outputs
+    Hash[].tap do |result|
+      self.class.outputs.each do |name, ivar|
+        result[name] = instance_variable_defined?(ivar) ? instance_variable_get(ivar) : nil
+      end
+    end
+  end
+
+  # @api private
+  module ClassMethods
+    def call(*args, &block)
+      new.call(*args, &block)
+    end
+
+    # @api private
+    def self.extended(interactor)
+      interactor.class_eval do
+        singleton_class.class_eval do
+          attr_accessor(:outputs)
+        end
+
+        self.outputs = {}
+      end
+    end
+
+    def method_added(method_name)
+      super
+      return unless method_name == :call
+
+      prepend Commande::Interface
+    end
+
+    # Expose local instance variables into the returning value of <tt>#call</tt>
+    #
+    # @param instance_variable_names [Symbol,Array<Symbol>] one or more instance
+    #   variable names
+    #
+    # @see Commande::Result
+    #
+    def output(*instance_variable_names)
+      instance_variable_names.each do |name|
+        outputs[name.to_sym] = "@#{name}"
+      end
+    end
+  end
+end

data/lib/commande/minitest.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'commande/minitest/assertions/assert_successful'
+require 'commande/minitest/assertions/assert_valid'
+require 'commande/minitest/assertions/assert_with_error'

data/lib/commande/minitest/assertions/assert_successful.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Minitest
+  module Assertions
+    def assert_successful(actual)
+      assert successful?(actual),
+             "Expected #{actual.inspect} to be successful?. Actual got these errors: #{actual.errors || ''}"
+    end
+
+    def refute_successful(actual)
+      refute successful?(actual),
+             "Expected #{actual.inspect} to not be successful?"
+    end
+
+    private
+
+    def successful?(actual)
+      actual.successful?
+    end
+  end
+end

data/lib/commande/minitest/assertions/assert_valid.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Minitest
+  module Assertions
+    def assert_valid(actual, *args)
+      assert valid?(actual, *args),
+             "Expected #{actual.inspect} to be valid?"
+    end
+
+    def refute_valid(actual, *args)
+      refute valid?(actual, *args),
+             "Expected #{actual.inspect} to not be valid?"
+    end
+
+    private
+
+    def valid?(actual, *args)
+      actual.valid?(*args)
+    end
+  end
+end

data/lib/commande/minitest/assertions/assert_with_error.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Minitest
+  module Assertions
+    def assert_with_error(expected, actual)
+      assert with_error(expected, actual),
+             "Expected #{actual.errors} to have an error '#{expected}'."
+    end
+
+    def refute_with_error(expected, actual)
+      refute with_error(expected, actual),
+             "Expected #{actual.errors} to not have an error '#{expected}'."
+    end
+
+    private
+
+    def with_error(expected, actual)
+      actual.errors.any? do |error|
+        expected == error
+      end
+    end
+  end
+end

data/lib/commande/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Commande
+  VERSION = '0.3.0'
+end

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification
+name: commande
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: ruby
+authors:
+- Derk-Jan Karrenbeld
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-06-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !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'
+description: 
+email:
+- derk-jan+github@karrenbeld.info
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".travis.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- commande.gemspec
+- lib/command.rb
+- lib/command/minitest.rb
+- lib/command/minitest/assertions/assert_successful.rb
+- lib/command/minitest/assertions/assert_valid.rb
+- lib/command/minitest/assertions/assert_with_error.rb
+- lib/commande.rb
+- lib/commande/minitest.rb
+- lib/commande/minitest/assertions/assert_successful.rb
+- lib/commande/minitest/assertions/assert_valid.rb
+- lib/commande/minitest/assertions/assert_with_error.rb
+- lib/commande/version.rb
+homepage: 
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/SleeplessByte/command/issues
+  changelog_uri: https://github.com/SleeplessByte/command/CHANGELOG.md
+  homepage_uri: https://github.com/SleeplessByte/command
+  source_code_uri: https://github.com/SleeplessByte/command
+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.14.1
+signing_key: 
+specification_version: 4
+summary: Allows for Command pattern style POROs
+test_files: []