u-service 0.13.0 → 0.13.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f637ed45a67693473bf30661b6a4822f1d6ea15246d46b24df3051546781a16b
-  data.tar.gz: ec7c4d4c8052ff1f293b9323bdb447505880dd658a1d0e6219dd2233a40a2b1a
+  metadata.gz: b93d4099f9d4f7646b94241bb5b66190635dff1a56781c7aa152fb458acce958
+  data.tar.gz: bf4a7a017a8fbc891904a74ffa80b8aaaadc577cfcfd178e062ed42410dfec9a
 SHA512:
-  metadata.gz: 5339646f0ce88b4842c9f8d0425ddb16c5edacb81f97dea46eb695da625a2b142fb24a15bf7256f16952f5fb45526c0d812ab8e7a54ac045ce49959ff5a1b637
-  data.tar.gz: 1927b9f7da2f9a5ca5ea369c768173485ff704e3fb8142eccaa612484e6c83a9aeba7589c11f61d573ed7a0b341ba437003f5e9e57bb74eb76ef5789fde84169
+  metadata.gz: 7d69adaf4e77a2707904a31a29ffd51abc866a27cdd210039b24c5def4ce9fbbbb0dec88e0b39bbfe6e855692d2a186c0931de6225d0269de6b972f048de936e
+  data.tar.gz: eb3812b5a44fa8742560eee26e49fd987f6bb4a5fb30e35aafa6a0b6d870c4a96b62a9a1af5b5387c7a58b8e97d45e739b64b4768d95bdd53c3784fa4df879f2

data/lib/micro/service/version.rb

@@ -2,6 +2,6 @@
 
 module Micro
   module Service
-    VERSION = '0.13.0'.freeze
+    VERSION = '0.13.1'.freeze
   end
 end

data/u-service.gemspec

@@ -29,7 +29,7 @@ Gem::Specification.new do |spec|
   # 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         = Dir.chdir(File.expand_path('..', __FILE__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|assets|benchmarks|comparisons|examples)/}) }
   end
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: u-service
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.13.1
 platform: ruby
 authors:
 - Rodrigo Serradura
@@ -68,23 +68,8 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- assets/u-service_benchmarks.png
-- benchmarks/interactor/pipeline_failure.rb
-- benchmarks/interactor/pipeline_success.rb
-- benchmarks/interactor/service_failure.rb
-- benchmarks/interactor/service_success.rb
 - bin/console
 - bin/setup
-- comparisons/interactor.rb
-- comparisons/u-service.rb
-- examples/calculator/README.md
-- examples/calculator/Rakefile
-- examples/calculator/assets/usage.gif
-- examples/calculator/calc/normalize_args.rb
-- examples/calculator/calc/operation.rb
-- examples/calculator/calc/transform_into_numbers.rb
-- examples/rescuing_exceptions.rb
-- examples/users_creation.rb
 - lib/micro/service.rb
 - lib/micro/service/base.rb
 - lib/micro/service/pipeline.rb

data/benchmarks/interactor/pipeline_failure.rb

@@ -1,134 +0,0 @@
-require 'bundler/inline'
-
-gemfile do
-  source 'https://rubygems.org'
-
-  gem 'benchmark-ips', '~> 2.7', '>= 2.7.2'
-  gem 'interactor', '~> 3.1', '>= 3.1.1'
-  gem 'u-service', '~> 0.12.0'
-end
-
-require 'benchmark/ips'
-
-module IT
-  class ConvertToNumbers
-    include Interactor
-
-    def call
-      numbers = context.numbers
-
-      if numbers.all? { |value| String(value) =~ /\d+/ }
-        context.numbers = numbers.map(&:to_i)
-      else
-        context.fail! numbers: 'must contain only numeric types'
-      end
-    end
-  end
-
-  class Add2
-    include Interactor
-
-    def call
-      numbers = context.numbers
-
-      context.numbers = numbers.map { |number| number + 2 }
-    end
-  end
-
-  class Add2ToAllNumbers
-    include Interactor::Organizer
-
-    organize ConvertToNumbers, Add2
-  end
-end
-
-module MSB
-  class ConvertToNumbers < Micro::Service::Base
-    attribute :numbers
-
-    def call!
-      if numbers.all? { |value| String(value) =~ /\d+/ }
-        Success(numbers: numbers.map(&:to_i))
-      else
-        Failure(numbers: 'must contain only numeric types')
-      end
-    end
-  end
-
-  class Add2 < Micro::Service::Base
-    attribute :numbers
-
-    def call!
-      Success(numbers: numbers.map { |number| number + 2 })
-    end
-  end
-
-  Add2ToAllNumbers = ConvertToNumbers >> Add2
-end
-
-module MSS
-  class ConvertToNumbers < Micro::Service::Strict
-    attribute :numbers
-
-    def call!
-      if numbers.all? { |value| String(value) =~ /\d+/ }
-        Success(numbers: numbers.map(&:to_i))
-      else
-        Failure(numbers: 'must contain only numeric types')
-      end
-    end
-  end
-
-  class Add2 < Micro::Service::Strict
-    attribute :numbers
-
-    def call!
-      Success(numbers: numbers.map { |number| number + 2 })
-    end
-  end
-
-  Add2ToAllNumbers = ConvertToNumbers >> Add2
-end
-
-NUMBERS = {numbers: %w[1 1 2 2 c 4]}
-
-Benchmark.ips do |x|
-  x.config(:time => 5, :warmup => 2)
-
-  x.time = 5
-  x.warmup = 2
-
-  x.report('Interactor::Organizer') do
-    IT::Add2ToAllNumbers.call(NUMBERS)
-  end
-
-  x.report('Pipeline of Micro::Service::Base') do
-    MSB::Add2ToAllNumbers.call(NUMBERS)
-  end
-
-  x.report('Pipeline of Micro::Service::Strict') do
-    MSS::Add2ToAllNumbers.call(NUMBERS)
-  end
-
-  x.compare!
-end
-
-# Warming up --------------------------------------
-# Interactor::Organizer
-#                          2.355k i/100ms
-# Pipeline of Micro::Service::Base
-#                         15.483k i/100ms
-# Pipeline of Micro::Service::Strict
-#                         13.467k i/100ms
-# Calculating -------------------------------------
-# Interactor::Organizer
-#                          23.767k (± 2.1%) i/s -    120.105k in   5.055726s
-# Pipeline of Micro::Service::Base
-#                         166.013k (± 1.8%) i/s -    836.082k in   5.037938s
-# Pipeline of Micro::Service::Strict
-#                         141.545k (± 2.1%) i/s -    713.751k in   5.044932s
-
-# Comparison:
-# Pipeline of Micro::Service::Base:   166013.1 i/s
-# Pipeline of Micro::Service::Strict: 141545.4 i/s - 1.17x  slower
-# Interactor::Organizer:              23766.6 i/s - 6.99x  slower

data/benchmarks/interactor/pipeline_success.rb

@@ -1,134 +0,0 @@
-require 'bundler/inline'
-
-gemfile do
-  source 'https://rubygems.org'
-
-  gem 'benchmark-ips', '~> 2.7', '>= 2.7.2'
-  gem 'interactor', '~> 3.1', '>= 3.1.1'
-  gem 'u-service', '~> 0.12.0'
-end
-
-require 'benchmark/ips'
-
-module IT
-  class ConvertToNumbers
-    include Interactor
-
-    def call
-      numbers = context.numbers
-
-      if numbers.all? { |value| String(value) =~ /\d+/ }
-        context.numbers = numbers.map(&:to_i)
-      else
-        context.fail! numbers: 'must contain only numeric types'
-      end
-    end
-  end
-
-  class Add2
-    include Interactor
-
-    def call
-      numbers = context.numbers
-
-      context.numbers = numbers.map { |number| number + 2 }
-    end
-  end
-
-  class Add2ToAllNumbers
-    include Interactor::Organizer
-
-    organize ConvertToNumbers, Add2
-  end
-end
-
-module MSB
-  class ConvertToNumbers < Micro::Service::Base
-    attribute :numbers
-
-    def call!
-      if numbers.all? { |value| String(value) =~ /\d+/ }
-        Success(numbers: numbers.map(&:to_i))
-      else
-        Failure(numbers: 'must contain only numeric types')
-      end
-    end
-  end
-
-  class Add2 < Micro::Service::Base
-    attribute :numbers
-
-    def call!
-      Success(numbers: numbers.map { |number| number + 2 })
-    end
-  end
-
-  Add2ToAllNumbers = ConvertToNumbers >> Add2
-end
-
-module MSS
-  class ConvertToNumbers < Micro::Service::Strict
-    attribute :numbers
-
-    def call!
-      if numbers.all? { |value| String(value) =~ /\d+/ }
-        Success(numbers: numbers.map(&:to_i))
-      else
-        Failure(numbers: 'must contain only numeric types')
-      end
-    end
-  end
-
-  class Add2 < Micro::Service::Strict
-    attribute :numbers
-
-    def call!
-      Success(numbers: numbers.map { |number| number + 2 })
-    end
-  end
-
-  Add2ToAllNumbers = ConvertToNumbers >> Add2
-end
-
-NUMBERS = {numbers: %w[1 1 2 2 3 4]}
-
-Benchmark.ips do |x|
-  x.config(:time => 5, :warmup => 2)
-
-  x.time = 5
-  x.warmup = 2
-
-  x.report('Interactor::Organizer') do
-    IT::Add2ToAllNumbers.call(NUMBERS)
-  end
-
-  x.report('Pipeline of Micro::Service::Base') do
-    MSB::Add2ToAllNumbers.call(NUMBERS)
-  end
-
-  x.report('Pipeline of Micro::Service::Strict') do
-    MSS::Add2ToAllNumbers.call(NUMBERS)
-  end
-
-  x.compare!
-end
-
-# Warming up --------------------------------------
-# Interactor::Organizer
-#                          5.047k i/100ms
-# Pipeline of Micro::Service::Base
-#                          8.069k i/100ms
-# Pipeline of Micro::Service::Strict
-#                          6.706k i/100ms
-# Calculating -------------------------------------
-# Interactor::Organizer
-#                          50.656k (± 2.4%) i/s -    257.397k in   5.084184s
-# Pipeline of Micro::Service::Base
-#                          83.309k (± 1.5%) i/s -    419.588k in   5.037749s
-# Pipeline of Micro::Service::Strict
-#                          69.195k (± 1.7%) i/s -    348.712k in   5.041089s
-
-# Comparison:
-# Pipeline of Micro::Service::Base:   83309.3 i/s
-# Pipeline of Micro::Service::Strict: 69195.1 i/s - 1.20x  slower
-# Interactor::Organizer:              50656.5 i/s - 1.64x  slower

data/benchmarks/interactor/service_failure.rb

@@ -1,93 +0,0 @@
-require 'bundler/inline'
-
-gemfile do
-  source 'https://rubygems.org'
-
-  gem 'benchmark-ips', '~> 2.7', '>= 2.7.2'
-  gem 'interactor', '~> 3.1', '>= 3.1.1'
-  gem 'u-service', '~> 0.12.0'
-end
-
-require 'benchmark/ips'
-
-class IT_Multiply
-  include Interactor
-
-  def call
-    a = context.a
-    b = context.b
-
-    if a.is_a?(Numeric) && b.is_a?(Numeric)
-      context.number = a * b
-    else
-      context.fail!(type: :invalid_data)
-    end
-  end
-end
-
-class MSB_Multiply < Micro::Service::Base
-  attributes :a, :b
-
-  def call!
-    if a.is_a?(Numeric) && b.is_a?(Numeric)
-      Success(a * b)
-    else
-      Failure(:invalid_data)
-    end
-  end
-end
-
-class MSS_Multiply < Micro::Service::Strict
-  attributes :a, :b
-
-  def call!
-    if a.is_a?(Numeric) && b.is_a?(Numeric)
-      Success(a * b)
-    else
-      Failure(:invalid_data)
-    end
-  end
-end
-
-SYMBOL_KEYS = { a: nil, b: 2 }
-STRING_KEYS = { 'a' => 1, 'b' => '' }
-
-Benchmark.ips do |x|
-  x.config(:time => 5, :warmup => 2)
-
-  x.time = 5
-  x.warmup = 2
-
-  x.report('Interactor') do
-    IT_Multiply.call(SYMBOL_KEYS)
-    IT_Multiply.call(STRING_KEYS)
-  end
-
-  x.report('Micro::Service::Base') do
-    MSB_Multiply.call(SYMBOL_KEYS)
-    MSB_Multiply.call(STRING_KEYS)
-  end
-
-  x.report('Micro::Service::Strict') do
-    MSS_Multiply.call(SYMBOL_KEYS)
-    MSS_Multiply.call(STRING_KEYS)
-  end
-
-  x.compare!
-end
-
-# Warming up --------------------------------------
-#           Interactor     1.507k i/100ms
-# Micro::Service::Base    12.902k i/100ms
-# Micro::Service::Strict
-#                          9.758k i/100ms
-# Calculating -------------------------------------
-#           Interactor     15.482k (± 2.6%) i/s -     78.364k in   5.065166s
-# Micro::Service::Base    134.861k (± 1.3%) i/s -    683.806k in   5.071263s
-# Micro::Service::Strict
-#                         101.331k (± 1.5%) i/s -    507.416k in   5.008688s
-
-# Comparison:
-# Micro::Service::Base:   134861.1 i/s
-# Micro::Service::Strict: 101331.5 i/s - 1.33x  slower
-#           Interactor:   15482.0 i/s - 8.71x  slower

data/benchmarks/interactor/service_success.rb

@@ -1,93 +0,0 @@
-require 'bundler/inline'
-
-gemfile do
-  source 'https://rubygems.org'
-
-  gem 'benchmark-ips', '~> 2.7', '>= 2.7.2'
-  gem 'interactor', '~> 3.1', '>= 3.1.1'
-  gem 'u-service', '~> 0.12.0'
-end
-
-require 'benchmark/ips'
-
-class IT_Multiply
-  include Interactor
-
-  def call
-    a = context.a
-    b = context.b
-
-    if a.is_a?(Numeric) && b.is_a?(Numeric)
-      context.number = a * b
-    else
-      context.fail!(:invalid_data)
-    end
-  end
-end
-
-class MSB_Multiply < Micro::Service::Base
-  attributes :a, :b
-
-  def call!
-    if a.is_a?(Numeric) && b.is_a?(Numeric)
-      Success(a * b)
-    else
-      Failure(:invalid_data)
-    end
-  end
-end
-
-class MSS_Multiply < Micro::Service::Strict
-  attributes :a, :b
-
-  def call!
-    if a.is_a?(Numeric) && b.is_a?(Numeric)
-      Success(a * b)
-    else
-      Failure(:invalid_data)
-    end
-  end
-end
-
-SYMBOL_KEYS = { a: 2, b: 2 }
-STRING_KEYS = { 'a' => 1, 'b' => 1 }
-
-Benchmark.ips do |x|
-  x.config(:time => 5, :warmup => 2)
-
-  x.time = 5
-  x.warmup = 2
-
-  x.report('Interactor') do
-    IT_Multiply.call(SYMBOL_KEYS)
-    IT_Multiply.call(STRING_KEYS)
-  end
-
-  x.report('Micro::Service::Base') do
-    MSB_Multiply.call(SYMBOL_KEYS)
-    MSB_Multiply.call(STRING_KEYS)
-  end
-
-  x.report('Micro::Service::Strict') do
-    MSS_Multiply.call(SYMBOL_KEYS)
-    MSS_Multiply.call(STRING_KEYS)
-  end
-
-  x.compare!
-end
-
-# Warming up --------------------------------------
-#           Interactor     2.943k i/100ms
-# Micro::Service::Base    12.540k i/100ms
-# Micro::Service::Strict
-#                          9.584k i/100ms
-# Calculating -------------------------------------
-#           Interactor     29.874k (± 2.7%) i/s -    150.093k in   5.027909s
-# Micro::Service::Base    131.440k (± 1.9%) i/s -    664.620k in   5.058327s
-# Micro::Service::Strict
-#                          99.111k (± 2.2%) i/s -    498.368k in   5.031006s
-
-# Comparison:
-# Micro::Service::Base:   131440.3 i/s
-# Micro::Service::Strict: 99111.3 i/s - 1.33x  slower
-#           Interactor:   29873.6 i/s - 4.40x  slower

data/comparisons/interactor.rb

@@ -1,57 +0,0 @@
-class CreateResponse
-  include Interactor
-
-  def call
-    responder = context.responder
-
-    survey_response = responder.survey_responses.build(
-      response_text: context.answers[:text],
-      rating: answers[:rating]
-      survey: context.survey
-    )
-
-    if survey_response.save
-      context.survey_response = survey_response
-    else
-      context.fail!(errors: survey_response.errors)
-    end
-  end
-end
-
-class AddRewardPoints
-  include Interactor
-
-  def call
-    reward_account = context.responder.reward_account
-
-    reward_account.balance += context.survey.reward_points
-
-    unless reward_account.save
-      context.fail!(errors: reward_account.errors)
-    end
-  end
-end
-
-class SendNotifications
-  include Interactor
-
-  def call
-    sender = context.survey.sender
-
-    SurveyMailer.delay.notify_responder(context.responder.id)
-    SurveyMailer.delay.notify_sender(sender.id)
-
-    unless sender.add_survey_response_notification
-      context.fail!(errors: sender.errors)
-    end
-  end
-end
-
-class ReplyToSurvey
-  include Interactor::Organizer
-
-  organize CreateResponse, AddRewardPoints, SendNotifications
-end
-
-# https://gist.githubusercontent.com/raderj89/cbb84b1f75e67087388bc4cdbe617138/raw/a39c3ba6b416ac3919cc7d32bfa58e82211f24ef/interactor_example.rb
-# https://medium.com/reflektive-engineering/from-service-objects-to-interactors-db7d2bb7dfd9

data/comparisons/u-service.rb

@@ -1,61 +0,0 @@
-class CreateResponse < Micro::Service::Strict
-  attributes :responder, :answers, :survey
-
-  def call!
-    survey_response = responder.survey_responses.build(
-      response_text: answers[:text],
-      rating: answers[:rating]
-      survey: survey
-    )
-
-    return Success { attributes(:responder, :survey) } if survey_response.save
-
-    Failure(:survey_response) { survey_response.errors }
-  end
-end
-
-class AddRewardPoints < Micro::Service::Strict
-  attributes :responder, :survey
-
-  def call!
-    reward_account = responder.reward_account
-    reward_account.balance += survey.reward_points
-
-    return Success { attributes(:responder, :survey) } if reward_account.save
-
-    Failure(:reward_account) { reward_account.errors }
-  end
-end
-
-class SendNotifications < Micro::Service::Strict
-  attributes :responder, :survey
-
-  def call!
-    sender = survey.sender
-
-    SurveyMailer.delay.notify_responder(responder.id)
-    SurveyMailer.delay.notify_sender(sender.id)
-
-    return Success { attributes(:survey) } if sender.add_survey_response_notification
-
-    Failure(:sender) { sender.errors }
-  end
-end
-
-ReplyToSurvey = CreateResponse >> AddRewardPoints >> SendNotifications
-
-# or
-
-ReplyToSurvey = Micro::Service::Pipeline[
-  CreateResponse,
-  AddRewardPoints,
-  SendNotifications
-]
-
-# or
-
-class ReplyToSurvey
-  include Micro::Service::Pipeline
-
-  pipeline CreateResponse, AddRewardPoints, SendNotifications
-end

data/examples/calculator/README.md

@@ -1,56 +0,0 @@
-# μ-service - Calculator example
-
-This example uses [rake](http://rubygems.org/gems/rake) to expose a CLI calculator.
-
-## Installation instructions
-```sh
-gem install rake
-gem install u-service -v 0.12.0
-```
-
-### Usage
-
-![gif](https://github.com/serradura/u-service/blob/master/examples/calculator/assets/usage.gif?raw=true)
-
-#### Listing the available rake tasks
-```sh
-rake -T
-
-# rake calc:add[a,b]       # adds two numbers
-# rake calc:divide[a,b]    # divides two numbers
-# rake calc:multiply[a,b]  # multiplies two numbers
-# rake calc:subtract[a,b]  # subtracts two numbers
-```
-
-#### Calculating integer numbers
-```sh
-rake calc:add[3,2]
-# 3 + 2 = 5
-
-rake calc:subtract[3,2]
-# 3 - 2 = 1
-
-rake calc:multiply[3,2]
-# 3 x 2 = 6
-
-rake calc:divide[3,2]
-# 3 / 2 = 1
-```
-
-#### Calculating float numbers
-```sh
-rake calc:divide[3.0,2.0]
-# 3.0 / 2.0 = 1.5
-
-rake calc:divide[-3.0,2.0]
-# -3.0 / 2.0 = -1.5
-```
-
-#### Calculation errors
-```sh
-rake calc:add[1,a]
-# ERROR: The arguments must contain only numeric values
-
-rake calc:add[-\ 1,2]
-# ERROR: Arguments can't have spaces: a: "- 1", b: "2"
-```

data/examples/calculator/Rakefile

@@ -1,60 +0,0 @@
-require 'u-service'
-
-require_relative 'calc/operation'
-require_relative 'calc/normalize_args'
-require_relative 'calc/transform_into_numbers'
-
-module Calc
-  TransformArgsIntoNumbers = NormalizeArgs >> TransformIntoNumbers
-
-  module With
-    Add = TransformArgsIntoNumbers >> Operation::Add
-    Divide = TransformArgsIntoNumbers >> Operation::Divide
-    Subtract = TransformArgsIntoNumbers >> Operation::Subtract
-    Multiply = TransformArgsIntoNumbers >> Operation::Multiply
-  end
-end
-
-class PerformTask < Micro::Service::Base
-  attributes :args, :operation
-
-  def call!
-    operation
-      .call(args: args)
-      .on_success { |value| print_operation(value) }
-      .on_failure(:not_a_number) { |message| puts "ERROR: #{message}" }
-      .on_failure(:arguments_with_space_chars) do |(a, b)|
-        puts "ERROR: Arguments can't have spaces: a: #{a}, b: #{b}"
-      end
-  end
-
-  private def print_operation(a:, operator:, b:, result:)
-    puts "#{a} #{operator} #{b} = #{result}"
-  end
-end
-
-namespace :calc do
-  desc 'adds two numbers'
-  task :add, [:a, :b] do |_task, args|
-    PerformTask.call(args: args, operation: Calc::With::Add)
-  end
-
-  desc 'divides two numbers'
-  task :divide, [:a, :b] do |_task, args|
-    begin
-      PerformTask.call(args: args, operation: Calc::With::Divide)
-    rescue ZeroDivisionError => e
-      puts "ERROR: #{e.message}"
-    end
-  end
-
-  desc 'subtracts two numbers'
-  task :subtract, [:a, :b] do |_task, args|
-    PerformTask.call(args: args, operation: Calc::With::Subtract)
-  end
-
-  desc 'multiplies two numbers'
-  task :multiply, [:a, :b] do |_task, args|
-    PerformTask.call(args: args, operation: Calc::With::Multiply)
-  end
-end

data/examples/calculator/calc/normalize_args.rb

@@ -1,17 +0,0 @@
-module Calc
-  class NormalizeArgs < Micro::Service::Base
-    attributes :args
-
-    def call!
-      a, b = normalize(args[:a]), normalize(args[:b])
-
-      return Success(a: a, b: b) if a !~ /\s/ && b !~ /\s/
-
-      Failure(:arguments_with_space_chars) { [a.inspect, b.inspect] }
-    end
-
-    private def normalize(value)
-      String(value).strip
-    end
-  end
-end

data/examples/calculator/calc/operation.rb

@@ -1,39 +0,0 @@
-class Operation < Micro::Service::Base
-  attributes :a, :b
-
-  private def result_of(operation_result)
-    attributes(:a, :operator, :b).merge(result: operation_result)
-  end
-
-  class Add < Operation
-    attribute :operator, '+'
-
-    def call!
-      Success(result_of(a + b))
-    end
-  end
-
-  class Subtract < Operation
-    attribute :operator, '-'
-
-    def call!
-      Success(result_of(a - b))
-    end
-  end
-
-  class Multiply < Operation
-    attribute :operator, 'x'
-
-    def call!
-      Success(result_of(a * b))
-    end
-  end
-
-  class Divide < Operation
-    attribute :operator, '/'
-
-    def call!
-      Success(result_of(a / b))
-    end
-  end
-end

data/examples/calculator/calc/transform_into_numbers.rb

@@ -1,18 +0,0 @@
-class TransformIntoNumbers < Micro::Service::Base
-  attributes :a, :b
-
-  def call!
-    number_a, number_b = number(a), number(b)
-
-    if number_a && number_b
-      Success(a: number(a), b: number(b))
-    else
-      Failure(:not_a_number) { 'The arguments must contain only numeric values' }
-    end
-  end
-
-  private def number(value)
-    return value.to_i if value =~ /\A[\-,=]?\d+\z/
-    return value.to_f if value =~ /\A[\-,=]?\d+\.\d+\z/
-  end
-end

data/examples/rescuing_exceptions.rb

@@ -1,53 +0,0 @@
-require 'bundler/inline'
-
-gemfile do
-  source 'https://rubygems.org'
-
-  gem 'u-service', '~> 0.12.0'
-end
-
-class Divide < Micro::Service::Base
-  attributes :a, :b
-
-  def call!
-    return Failure('numbers must be greater than 0') if a < 0 || b < 0
-
-    Success(a / b)
-  rescue => e
-    Failure(e.message)
-  end
-end
-
-#---------------------------------#
-puts "\n-- Success scenario --\n\n"
-#---------------------------------#
-
-result = Divide.call(a: 4, b: 2)
-
-puts result.value if result.success?
-
-#----------------------------------#
-puts "\n-- Failure scenarios --\n\n"
-#----------------------------------#
-
-result = Divide.call(a: 4, b: 0)
-
-puts result.value if result.failure?
-
-puts ''
-
-result = Divide.call(a: -4, b: 2)
-
-puts result.value if result.failure?
-
-# :: example of the output: ::
-
-# -- Success scenario --
-#
-# 2
-#
-# -- Failure scenarios --
-#
-# divided by 0
-#
-# numbers must be greater than 0

data/examples/users_creation.rb

@@ -1,133 +0,0 @@
-require 'bundler/inline'
-
-gemfile do
-  source 'https://rubygems.org'
-
-  # NOTE: I used an older version of the Activemodel only to show the compatibility with its older versions.
-  gem 'activemodel', '~> 3.2', '>= 3.2.22.5'
-  gem 'u-service', '~> 0.12.0'
-end
-
-require 'micro/service/with_validation'
-
-module Users
-  class Entity
-    include Micro::Attributes.with(:initialize)
-
-    attributes :id, :name, :email
-
-    def persisted?
-      !id.nil?
-    end
-  end
-
-  module Creation
-    require 'uri'
-    require 'securerandom'
-
-    class ProcessParams < Micro::Service::Base
-      attributes :name, :email
-
-      def call!
-        Success(name: normalized_name, email: String(email).downcase.strip)
-      end
-
-      private def normalized_name
-        String(name).strip.gsub(/\s+/, ' ')
-      end
-    end
-
-    class ValidateParams < Micro::Service::WithValidation
-      attributes :name, :email
-
-      validates :name, presence: true
-      validates :email, format: { with: URI::MailTo::EMAIL_REGEXP }
-
-      def call!
-        Success(attributes(:name, :email))
-      end
-    end
-
-    class Persist < Micro::Service::Base
-      attributes :name, :email
-
-      def call!
-        Success(user: Entity.new(user_data))
-      end
-
-      private def user_data
-        attributes.merge(id: SecureRandom.uuid)
-      end
-    end
-
-    class SendToCRM < Micro::Service::Base
-      attribute :user
-
-      def call!
-        return Success(user_id: user.id, crm_id: send_to_crm) if user.persisted?
-
-        Failure(:crm_error) { 'User can\'t be sent to the CRM' }
-      end
-
-      private def send_to_crm
-        # Do some integration stuff...
-        SecureRandom.uuid
-      end
-    end
-
-    Process = ProcessParams >> ValidateParams >> Persist >> SendToCRM
-  end
-end
-
-require 'pp'
-
-params = {
-  "name" => "  Rodrigo  \n  Serradura ",
-  "email" => "   RoDRIGo.SERRAdura@gmail.com   "
-}
-
-#--------------------------------------#
-puts "\n-- Parameters processing --\n\n"
-#--------------------------------------#
-
-print 'Before: '
-p params
-
-print ' After: '
-Users::Creation::ProcessParams.call(params).on_success { |value| p value }
-
-#---------------------------------#
-puts "\n-- Success scenario --\n\n"
-#---------------------------------#
-
-Users::Creation::Process
-  .call(params)
-  .on_success do |user_id:, crm_id:|
-    puts " CRM ID: #{crm_id}"
-    puts "USER ID: #{user_id}"
-  end
-
-#---------------------------------#
-puts "\n-- Failure scenario --\n\n"
-#---------------------------------#
-
-Users::Creation::Process
-  .call(name: '', email: '')
-  .on_failure { |errors:| p errors.full_messages }
-
-
-# :: example of the output: ::
-
-# -- Parameters processing --
-#
-# Before: {"name"=>"  Rodrigo  \n  Serradura ", "email"=>"   RoDRIGo.SERRAdura@gmail.com   "}
-#  After: {:name=>"Rodrigo Serradura", :email=>"rodrigo.serradura@gmail.com"}
-#
-# -- Success scenario --
-#
-#  CRM ID: f3f189f6-ba6a-40ab-998c-c86773c41c83
-# USER ID: c140ffc3-6a7c-4554-972a-c2a0d59f8cb1
-#
-# -- Failure scenarios --
-#
-# ["Name can't be blank", "Email is invalid"]