defi 1.1.5 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 238e14dcedd8405b6c07e38ac76221ee3312b473985c9ce4de3323542667e962
-  data.tar.gz: 839fdb886247d8f35af842a7b1b3e1854e5d52ddd4b5a050b466f41285dafe9c
+  metadata.gz: 17965d0bae882875e8860597f6d6b7cc147837dad2a8622e505cf95aa9e9e752
+  data.tar.gz: 4500fc7d680aa05caa158c22f0dd9cd71f2f014be3b13e79cdbd488a82fdf278
 SHA512:
-  metadata.gz: 299bc2c941232744fc9e0e8648b4ac48f2505c0a98249d3e38184037f1e5b1bb03c1ed17324388a9e4f58c71f606a2ae7481b35d99b34be43a63b3241b83eaf5
-  data.tar.gz: 679c23e1b6d4411af7f63d6c04511d567a21c64c1dc628a25dd979d604b10b6ab2e731abeb3af18f6a87497d927d2027af5c947d409b7056d65938b5ff66c3b7
+  metadata.gz: 1e52fe5aaab97e0ebb05aa93f765f35690eb3e9460f736a2fed8737ac495b5636379a7e325307aed74e9394d59b160376b094e7105b89bbe334db3e24a360e01
+  data.tar.gz: 138f72b7a0aef3d48ed73f49383767cfb863aaa6230eb94ddf30f7e1431c15ffa7ddb48b8f5bd5df2d80512af1d235c368003c1216c8995bc9788e503e91aafb

data/README.md

@@ -1,10 +1,10 @@
 # Defi
 
-[![Build Status](https://travis-ci.org/fixrb/defi.svg?branch=master)][travis]
+[![Build Status](https://api.travis-ci.org/fixrb/defi.svg?branch=master)][travis]
 [![Code Climate](https://codeclimate.com/github/fixrb/defi/badges/gpa.svg)][codeclimate]
 [![Gem Version](https://badge.fury.io/rb/defi.svg)][gem]
-[![Inline docs](http://inch-ci.org/github/fixrb/defi.svg?branch=master)][inchpages]
-[![Documentation](http://img.shields.io/:yard-docs-38c800.svg)][rubydoc]
+[![Inline docs](https://inch-ci.org/github/fixrb/defi.svg?branch=master)][inchpages]
+[![Documentation](https://img.shields.io/:yard-docs-38c800.svg)][rubydoc]
 
 > Challenge library.
 
@@ -16,8 +16,8 @@
 ## Rubies
 
 * [MRI](https://www.ruby-lang.org/)
-* [Rubinius](http://rubini.us/)
-* [JRuby](http://jruby.org/)
+* [Rubinius](https://rubinius.com/)
+* [JRuby](https://www.jruby.org/)
 
 ## Installation
 
@@ -37,16 +37,24 @@ Or install it yourself as:
 
 ## Usage
 
-Let's challenge `6` to be multiplied by seven:
+Let's multiply by `7` the number `6`:
 
 ```ruby
-Defi.send(:*, 7).to(6) # => 42
+Defi.send(:*, 7).to(6).call # => 42
 ```
 
-Now, let's challenge `"foo"` to respond to a `boom` method:
+Now, let's challenge "`foo`" with `boom` method:
 
 ```ruby
-Defi.send(:boom).to('foo') # NoMethodError: undefined method `boom' for "foo":String
+Defi.send(:boom).to('foo').call # NoMethodError: undefined method `boom' for "foo":String
+```
+
+Let's challenge "`hello world`" with `gsub!` in isolation:
+
+```ruby
+some_text = 'hello world'
+Defi.send(:gsub!, 'world', 'Alice').to!(some_text).call # => "hello Alice"
+some_text # => "hello world"
 ```
 
 ## Security
@@ -64,7 +72,7 @@ example:
 
 ## Versioning
 
-__Defi__ follows [Semantic Versioning 2.0](http://semver.org/).
+__Defi__ follows [Semantic Versioning 2.0](https://semver.org/).
 
 ## Contributing
 
@@ -81,12 +89,15 @@ See `LICENSE.md` file.
 [gem]: https://rubygems.org/gems/defi
 [travis]: https://travis-ci.org/fixrb/defi
 [codeclimate]: https://codeclimate.com/github/fixrb/defi
-[gemnasium]: https://gemnasium.com/fixrb/defi
-[inchpages]: http://inch-ci.org/github/fixrb/defi
-[rubydoc]: http://rubydoc.info/gems/defi/frames
+[inchpages]: https://inch-ci.org/github/fixrb/defi
+[rubydoc]: https://rubydoc.info/gems/defi/frames
 
 ***
 
-This project is sponsored by:
+<p>
+  This project is sponsored by:
 
-[![Sashite](https://sashite.com/img/sashite.png)](https://sashite.com/)
+  <a href="https://sashite.com/"><img
+    src="https://github.com/fixrb/defi/raw/bdf560d73e7ff2306f6f4a071ced36b383cbf35d/img/sashite.png"
+    alt="Sashite" /></a>
+</p>

data/lib/defi.rb

@@ -12,12 +12,14 @@ module Defi
   # @example The challenge
   #   send(:foo) # => #<Defi::Challenge:0x007f96a40925f8 @method=:foo, @args=[]>
   #
-  # @param method [#to_sym] A public method.
-  # @param args   [Array]   A list of arguments.
+  # @param method [#to_sym] The method to send to an object.
+  # @param args   [Array]   Any arguments of the method.
+  # @param opts   [Hash]    Any keyword arguments of the method.
+  # @param block  [Proc]    Any block argument of the method.
   #
   # @return [Challenge] The challenge instance.
-  def self.send(method, *args)
-    Challenge.new(method, *args)
+  def self.send(method, *args, **opts, &block)
+    Challenge.new(method, *args, **opts, &block)
   end
 end
 

data/lib/defi/challenge.rb

@@ -1,29 +1,46 @@
 # frozen_string_literal: true
 
+require 'aw'
+
 module Defi
   # This class contains a challenge to apply against an object.
   #
   # @api private
   #
-  class Challenge
+  class Challenge < ::BasicObject
     # Initialize the challenge class.
     #
     # @api private
     #
     # @param method [#to_sym] The method to send to an object.
-    # @param args   [Array]   The arguments of the method.
-    def initialize(method, *args)
+    # @param args   [Array]   Any arguments of the method.
+    # @param opts   [Hash]    Any keyword arguments of the method.
+    # @param block  [Proc]    Any block argument of the method.
+    def initialize(method, *args, **opts, &block)
       @method = method.to_sym
       @args   = args
+      @opts   = opts
+      @block  = block
     end
 
     # @api public
     #
     # @param object [#object_id] The object to challenge.
     #
-    # @return [#object_id] The actual value, or a raised exception.
+    # @return [Defi::Value] The actual value, to raise or to return.
     def to(object)
-      object.public_send(@method, *@args)
+      Value.new { object.public_send(@method, *@args, **@opts, &@block) }
+    end
+
+    # @api public
+    #
+    # @param object [#object_id] The object to challenge in code isolation.
+    #
+    # @return [Defi::Value] The actual value, to raise or to return.
+    #
+    # @see to
+    def to!(object)
+      ::Aw.fork! { to(object) }
     end
 
     # Properties of the challenge.
@@ -34,8 +51,56 @@ module Defi
     def to_h
       {
         method: @method,
-        args: @args
+        args:   @args,
+        opts:   @opts,
+        block:  @block
       }
     end
+
+    # String of the challenge.
+    #
+    # @api public
+    #
+    # @return [String] The string representation of the challenge.
+    def to_s
+      string = ".#{@method}"
+
+      return string if @args.empty? && @opts.empty? && @block.nil?
+
+      stringified_args  = @args.inspect[1..-2]
+      stringified_opts  = @opts.inspect[1..-2]
+      stringified_block = '<Proc>' unless @block.nil?
+
+      string += '('
+
+      stringified_items = []
+
+      stringified_items << stringified_args   unless @args.empty?
+      stringified_items << stringified_opts   unless @opts.empty?
+      stringified_items << stringified_block  unless @block.nil?
+
+      string + stringified_items.join(', ') + ')'
+    end
+
+    # A string containing a human-readable representation of the challenge.
+    #
+    # @api public
+    #
+    # @return [String] The human-readable representation of the challenge.
+    def inspect
+      inspected_method  = @method.inspect
+      inspected_args    = @args.inspect
+      inspected_opts    = @opts.inspect
+      inspected_block   = @block.nil? ? 'nil' : '<Proc>'
+
+      'Defi('                         \
+      "method: #{inspected_method}, " \
+      "args: #{  inspected_args  }, " \
+      "opts: #{  inspected_opts  }, " \
+      "block: #{ inspected_block }"   \
+      ')'
+    end
   end
 end
+
+require_relative 'value'

data/lib/defi/value.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Defi
+  # This class contains an object that returned or raised during the initialize.
+  #
+  # @api private
+  #
+  class Value
+    # @return [#object_id] The returned or the raised object.
+    attr_reader :object
+
+    # Initialize the value class.
+    #
+    # @api public
+    #
+    # @param block [Proc] The block of code to execute.
+    # rubocop:disable Lint/RescueException
+    def initialize(&block)
+      @object = block.call
+      @raised = false
+    rescue ::Exception => e
+      @object = e
+      @raised = true
+    end
+    # rubocop:enable Lint/RescueException
+
+    # Raise or return the value.
+    #
+    # @return [#object_id] Raised exception or returned object.
+    def call
+      raise object if raised?
+
+      object
+    end
+
+    # @api public
+    #
+    # @return [Boolean] The value was raised (or returned)?
+    def raised?
+      @raised
+    end
+
+    # Properties of the value.
+    #
+    # @api public
+    #
+    # @return [Hash] The properties of the value.
+    def to_h
+      {
+        raised: raised?,
+        object: object
+      }
+    end
+
+    # String of the value.
+    #
+    # @api public
+    #
+    # @return [String] The string representation of the value.
+    def to_s
+      string = if raised?
+                 'raise'
+               else
+                 'return'
+               end
+
+      "#{string} #{object}"
+    end
+
+    # A string containing a human-readable representation of the value.
+    #
+    # @api public
+    #
+    # @return [String] The human-readable representation of the value.
+    def inspect
+      "Value(object: #{object}, raised: #{raised?})"
+    end
+  end
+end

metadata

@@ -1,85 +1,99 @@
 --- !ruby/object:Gem::Specification
 name: defi
 version: !ruby/object:Gem::Version
-  version: 1.1.5
+  version: 2.0.0
 platform: ruby
 authors:
 - Cyril Kato
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-12 00:00:00.000000000 Z
+date: 2019-12-22 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: aw
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.10
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.10
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.3'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.3'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.67'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.67'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.16'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.16'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: spectus
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0.17'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0.17'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -95,35 +109,16 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.9'
 description: Challenge library.
-email:
-- contact@cyril.email
+email: contact@cyril.email
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rubocop.yml"
-- ".rubocop_todo.yml"
-- ".travis.yml"
-- CODE_OF_CONDUCT.md
-- Gemfile
 - LICENSE.md
 - README.md
-- Rakefile
-- VERSION.semver
-- bin/console
-- bin/setup
-- checksum/defi-0.1.0.gem.sha512
-- checksum/defi-1.0.0.gem.sha512
-- checksum/defi-1.1.0.gem.sha512
-- checksum/defi-1.1.1.gem.sha512
-- checksum/defi-1.1.2.gem.sha512
-- checksum/defi-1.1.3.gem.sha512
-- checksum/defi-1.1.4.gem.sha512
-- defi.gemspec
 - lib/defi.rb
 - lib/defi/challenge.rb
-- pkg_checksum
+- lib/defi/value.rb
 homepage: https://github.com/fixrb/defi
 licenses:
 - MIT
@@ -143,7 +138,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Challenge library.

data/.gitignore

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

data/.rubocop.yml

@@ -1 +0,0 @@
-inherit_from: .rubocop_todo.yml

data/.rubocop_todo.yml

@@ -1,12 +0,0 @@
-# This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2018-08-26 22:52:05 +0200 using RuboCop version 0.58.2.
-# The point is for the user to remove these configuration records
-# one by one as the offenses are removed from the code base.
-# Note that changes in the inspected code, or installation of new
-# versions of RuboCop, may require this file to be generated again.
-
-# Offense count: 1
-Style/MixinUsage:
-  Exclude:
-    - 'test/test_defi.rb'

data/.travis.yml

@@ -1,28 +0,0 @@
-language: ruby
-sudo: false
-cache: bundler
-before_install:
-  - gem install bundler
-script:
-  - bundle exec rubocop
-  - bundle exec rake test
-rvm:
-  - 2.3.3
-  - 2.4.0
-  - 2.5.0
-  - 2.6.1
-  - ruby-head
-  - jruby-head
-  - rbx-3
-matrix:
-  allow_failures:
-    - rvm: ruby-head
-    - rvm: jruby-head
-    - rvm: rbx-3
-notifications:
-  webhooks:
-    urls:
-      - https://webhooks.gitter.im/e/a44b19cc5cf6db25fa87
-    on_success: change
-    on_failure: always
-    on_start: never

data/CODE_OF_CONDUCT.md

@@ -1,13 +0,0 @@
-# Contributor Code of Conduct
-
-As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
-
-We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
-
-Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
-
-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. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
-
-This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-gemspec

data/Rakefile

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require 'bundler/gem_tasks'
-require 'rake/testtask'
-require 'rubocop/rake_task'
-
-RuboCop::RakeTask.new
-
-Rake::TestTask.new do |t|
-  t.verbose = true
-  t.warning = true
-end
-
-namespace :test do
-  task :coverage do
-    ENV['COVERAGE'] = 'true'
-    Rake::Task['test'].invoke
-  end
-end
-
-task(:doc_stats) { ruby '-S yard stats' }
-task default: %i[test doc_stats rubocop]

data/VERSION.semver

@@ -1 +0,0 @@
-1.1.5

data/bin/console

@@ -1,8 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require 'bundler/setup'
-require 'defi'
-
-require 'irb'
-IRB.start

data/bin/setup

@@ -1,6 +0,0 @@
-#!/bin/bash
-
-set -euo pipefail
-IFS=$'\n\t'
-
-bundle install

data/checksum/defi-0.1.0.gem.sha512

@@ -1 +0,0 @@
-a1bf7c28d86ef4f412a9294b4fc40d613ffdb6bc3a0410144d927fa95ba718e1ce7ac20e21845e99860529ad91f231e6436c4730e2ee1f6a13519476be207545

data/checksum/defi-1.0.0.gem.sha512

@@ -1 +0,0 @@
-c30380a253c932bbff42a36611466f2b7d59e6a1d9578a4989e7b2cfd4078cf9d64e452b0eaa055c5ab88be4816d3f366d7aa705d29bb54e2db9f75d21f36cf7

data/checksum/defi-1.1.0.gem.sha512

@@ -1 +0,0 @@
-3b9fea31dc30e80b1002d4989c7bfde2f78ad5ace812de13e05902097a85d81ba2d41fdeacfd1b99329513defab3243a74fb557bdc1bfa2cc8b35c30e4c7a074

data/checksum/defi-1.1.1.gem.sha512

@@ -1 +0,0 @@
-70f4feffaac82872d62f7875a1273204119e868f101beecbaabd8ee90414a24224edada97c6351c5250c2c0aa4a3e70c9c23be04a98376396cd20bbd930d45b2

data/checksum/defi-1.1.2.gem.sha512

@@ -1 +0,0 @@
-0d075e154c799ad24a8921266f042731cfcf32bd7308b22aa88fce7e552d49693be39595a66177df3b3f16776f4b4d76bb62887122af60865718ba5b050616a9

data/checksum/defi-1.1.3.gem.sha512

@@ -1 +0,0 @@
-5a72d6ae695508de8f650a813313a589b8f60940b0a702aac8f1674a0ad2965c1232023100f1ea58d0227ba37dfb52cf40c5ef34184bfeeba79fe1342c641ca2

data/checksum/defi-1.1.4.gem.sha512

@@ -1 +0,0 @@
-4d07dfc4a08dd053d718b3d092a1e368d396d4325a5b392927fe8d5c7feba2687b78001f42046b303c78bc5afc805f6bcc824807c38be329b0162f563b68cb7c

data/defi.gemspec

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-Gem::Specification.new do |spec|
-  spec.name          = 'defi'
-  spec.version       = File.read('VERSION.semver').chomp
-  spec.authors       = ['Cyril Kato']
-  spec.email         = ['contact@cyril.email']
-
-  spec.summary       = 'Challenge library.'
-  spec.description   = 'Challenge library.'
-  spec.homepage      = 'https://github.com/fixrb/defi'
-  spec.license       = 'MIT'
-
-  spec.files         =
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^test/}) }
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ['lib']
-
-  spec.add_development_dependency 'bundler',    '~> 2.0'
-  spec.add_development_dependency 'rake',       '~> 12.3'
-  spec.add_development_dependency 'rubocop',    '~> 0.67'
-  spec.add_development_dependency 'simplecov',  '~> 0.16'
-  spec.add_development_dependency 'spectus',    '~> 3.0'
-  spec.add_development_dependency 'yard',       '~> 0.9'
-end

data/pkg_checksum

@@ -1,12 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require 'digest/sha2'
-
-gemname         = :defi
-ARGV[0]         = File.read('VERSION.semver').chomp if ARGV[0].nil?
-built_gem_path  = "pkg/#{gemname}-#{ARGV[0]}.gem"
-checksum        = Digest::SHA512.new.hexdigest(File.read(built_gem_path))
-checksum_path   = "checksum/#{gemname}-#{ARGV[0]}.gem.sha512"
-
-File.open(checksum_path, 'w') { |f| f.write("#{checksum}\n") }