simple_command 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 34d0c5727245163347f97d47f2b6d1ee2427b3fc
-  data.tar.gz: 55e57dbdac2641a907b8186b822a32c1ce5584e0
+  metadata.gz: e1e044db947afd477d7b8042fbd679fdffbd8a63
+  data.tar.gz: 021cfb1817dd007895a76184af0db53095c0c9a1
 SHA512:
-  metadata.gz: 42f9820c03e53e70355decbf26c15d17559198404a171d3e5f37f54284b77f046a1094a69921abad73c34a793916066b301916ede8a8a0c88b74837ef72af3ce
-  data.tar.gz: a86431bceab44ee6e2a25dc328b5c8e57a71d7eeed8aabde579e6287272d8b9d890ef99737f96e43e666405c2a0056d7582aebfede4c631e8a4d9e3662ecd9dc
+  metadata.gz: 0a88837defef4d2cc6f3c7167e0f891f73dd09ff6378a5719df8772e8a4f1bdd7cd22043ca29b3596d9e53d619c9a714d03c2107a27d3746150c8f3d167d2730
+  data.tar.gz: ea8a66ec330153ba06932837a9795d7931c3741faed743c3ebdaa40e211ffde726a173121a84c6a91c89cca5561308373d04aca9d0a776764ce195d8f75694f2

data/README.md

@@ -38,9 +38,9 @@ class AuthenticateUser
     @password = password
   end
 
-  # mandatory: define a #perform method. its return value will be available
+  # mandatory: define a #call method. its return value will be available
   #            through #result
-  def perform
+  def call
     if user = User.authenticate(@email, @password)
       return user
     else
@@ -57,8 +57,8 @@ Then, in your controller:
 class SessionsController < ApplicationController
   def create
     # initialize and execute the command
-    # NOTE: `.perform` is a shortcut for `.new(args).perform)`
-    command = AuthenticateUser.perform(session_params[:user], session_params[:password])
+    # NOTE: `.call` is a shortcut for `.new(args).call)`
+    command = AuthenticateUser.call(session_params[:user], session_params[:password])
 
     # check command outcome
     if command.success?

data/lib/simple_command.rb

@@ -5,8 +5,8 @@ module SimpleCommand
   attr_reader :result
 
   module ClassMethods
-    def perform(*args)
-      new(*args).perform
+    def call(*args)
+      new(*args).call
     end
   end
 
@@ -14,21 +14,21 @@ module SimpleCommand
     base.extend ClassMethods
   end
 
-  def perform
+  def call
     fail NotImplementedError unless defined?(super)
 
-    @performed = true
+    @called = true
     @result = super
 
     self
   end
 
   def success?
-    performed? && !failure?
+    called? && !failure?
   end
 
   def failure?
-    performed? && errors.any?
+    called? && errors.any?
   end
 
   def errors
@@ -37,7 +37,7 @@ module SimpleCommand
 
   private
 
-  def performed?
-    @performed ||= false
+  def called?
+    @called ||= false
   end
 end

data/lib/simple_command/version.rb

@@ -1,3 +1,3 @@
 module SimpleCommand
-  VERSION = '0.0.7'
+  VERSION = '0.0.8'
 end

data/spec/factories/{missed_perform_command.rb → missed_call_command.rb}

@@ -1,4 +1,4 @@
-class MissedPerformCommand
+class MissedCallCommand
   prepend SimpleCommand
 
   def initialize(input)

data/spec/factories/success_command.rb

@@ -5,7 +5,7 @@ class SuccessCommand
     @input = input
   end
 
-  def perform
+  def call
     @input * 2
   end
 end

data/spec/simple_command_spec.rb

@@ -3,48 +3,48 @@ require 'spec_helper'
 describe SimpleCommand do
   let(:command) { SuccessCommand.new(2) }
 
-  describe '.perform' do
+  describe '.call' do
     before do
       allow(SuccessCommand).to receive(:new).and_return(command)
-      allow(command).to receive(:perform)
+      allow(command).to receive(:call)
 
-      SuccessCommand.perform 2
+      SuccessCommand.call 2
     end
 
     it 'initializes the command' do
       expect(SuccessCommand).to have_received(:new)
     end
 
-    it 'calls #perform method' do
-      expect(command).to have_received(:perform)
+    it 'calls #call method' do
+      expect(command).to have_received(:call)
     end
   end
 
-  describe '#perform' do
-    let(:missed_perform_command) { MissedPerformCommand.new(2) }
+  describe '#call' do
+    let(:missed_call_command) { MissedCallCommand.new(2) }
 
     it 'returns the command object' do
-      expect(command.perform).to be_a(SuccessCommand)
+      expect(command.call).to be_a(SuccessCommand)
     end
 
     it 'raises an exception if the method is not defined in the command' do
       expect do
-        missed_perform_command.perform
+        missed_call_command.call
       end.to raise_error(SimpleCommand::NotImplementedError)
     end
   end
 
   describe '#success?' do
     it 'is true by default' do
-      expect(command.perform.success?).to be_truthy
+      expect(command.call.success?).to be_truthy
     end
 
     it 'is false if something went wrong' do
       command.errors.add_error(:some_error, 'some message')
-      expect(command.perform.success?).to be_falsy
+      expect(command.call.success?).to be_falsy
     end
 
-    context 'when perform is not called yet' do
+    context 'when call is not called yet' do
       it 'is false by default' do
         expect(command.success?).to be_falsy
       end
@@ -53,10 +53,10 @@ describe SimpleCommand do
 
   describe '#result' do
     it 'returns the result of command execution' do
-      expect(command.perform.result).to eq(4)
+      expect(command.call.result).to eq(4)
     end
 
-    context 'when perform is not called yet' do
+    context 'when call is not called yet' do
       it 'returns nil' do
         expect(command.result).to be_nil
       end
@@ -65,15 +65,15 @@ describe SimpleCommand do
 
   describe '#failure?' do
     it 'is false by default' do
-      expect(command.perform.failure?).to be_falsy
+      expect(command.call.failure?).to be_falsy
     end
 
     it 'is true if something went wrong' do
       command.errors.add_error(:some_error, 'some message')
-      expect(command.perform.failure?).to be_truthy
+      expect(command.call.failure?).to be_truthy
     end
 
-    context 'when perform is not called yet' do
+    context 'when call is not called yet' do
       it 'is false by default' do
         expect(command.failure?).to be_falsy
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: simple_command
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Andrea Pavoni
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-16 00:00:00.000000000 Z
+date: 2015-01-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -71,7 +71,7 @@ files:
 - lib/simple_command/errors.rb
 - lib/simple_command/version.rb
 - simple_command.gemspec
-- spec/factories/missed_perform_command.rb
+- spec/factories/missed_call_command.rb
 - spec/factories/success_command.rb
 - spec/simple_command/errors_spec.rb
 - spec/simple_command_spec.rb
@@ -101,7 +101,7 @@ signing_key:
 specification_version: 4
 summary: Easy way to build and manage commands (service objects)
 test_files:
-- spec/factories/missed_perform_command.rb
+- spec/factories/missed_call_command.rb
 - spec/factories/success_command.rb
 - spec/simple_command/errors_spec.rb
 - spec/simple_command_spec.rb