typerb 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ce9f42a58f215a179f850016e0f647a4e16b4f23b3021d7cd17a43960857439
-  data.tar.gz: 9bb4dc2cb1f2396c7ccfd773d27a2d85e0d11f3a66ef54537e9c809594795d5a
+  metadata.gz: f7cef67daf67692e132e69a417bc8d7ea8162c56e87f7c058b5d095aed720506
+  data.tar.gz: 8493a01a0310fe1accb703ee82515b8f59163dc4069117774df00fafd0228113
 SHA512:
-  metadata.gz: a35899b9f7f7cc045725241d6eef0d312470016e2945edea86c67696c67f3ba69bbc52743fd51cb0253b6b7bc4f3be30ac9567784269a6f382d46484b9bc2476
-  data.tar.gz: 58c8a8839809ff2c87801388cca35dca300a565616645a01d9bd59fdea6e6986c74763250093400aaca8d2b91a47cfad8b24b0060b24ae0215a3bdb846617568
+  metadata.gz: e69f6c28e078a84bded21be966969c7979ab71f26dff4379b7952026c3ea180422ac68ae82b4e2ef003cd34cb47fd0902f474024758ff756984aaa0f937a7eae
+  data.tar.gz: f5ea90611dbd4429a48b11b59ce69d2e6f4e267e7d451916171bb06f680e64f6bec033f1f31dd7c6c6096f510123d1dc2b0aa50932630c0ec6406022bb81e2e9

data/.gitignore

@@ -6,6 +6,7 @@
 /pkg/
 /spec/reports/
 /tmp/
+/vendor/
 *.gem
 
 # rspec failure tracking

data/.rubocop.yml

@@ -2,6 +2,7 @@ AllCops:
   TargetRubyVersion: 2.4
   Exclude:
     - 'bin/**/*'
+    - 'Guardfile'
 
 inherit_mode:
   merge:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    typerb (0.1.6)
+    typerb (0.1.7)
 
 GEM
   remote: https://rubygems.org/
@@ -10,8 +10,33 @@ GEM
     awesome_print (1.8.0)
     coderay (1.1.2)
     diff-lcs (1.3)
+    ffi (1.9.25)
+    formatador (0.2.5)
+    guard (2.14.2)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (>= 1.0.12, < 2.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.7.3)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
     jaro_winkler (1.5.1)
+    listen (3.1.5)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+      ruby_dep (~> 1.2)
+    lumberjack (1.0.13)
     method_source (0.9.1)
+    nenv (0.3.0)
+    notiffany (0.1.1)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
     parallel (1.12.1)
     parser (2.5.3.0)
       ast (~> 2.4.0)
@@ -21,6 +46,9 @@ GEM
       method_source (~> 0.9.0)
     rainbow (3.0.0)
     rake (10.5.0)
+    rb-fsevent (0.10.3)
+    rb-inotify (0.9.10)
+      ffi (>= 0.5.0, < 2)
     rspec (3.8.0)
       rspec-core (~> 3.8.0)
       rspec-expectations (~> 3.8.0)
@@ -43,8 +71,11 @@ GEM
       ruby-progressbar (~> 1.7)
       unicode-display_width (~> 1.4.0)
     ruby-progressbar (1.10.0)
+    ruby_dep (1.5.0)
+    shellany (0.0.1)
     super_awesome_print (0.2.5)
       awesome_print
+    thor (0.20.0)
     unicode-display_width (1.4.0)
 
 PLATFORMS
@@ -52,6 +83,8 @@ PLATFORMS
 
 DEPENDENCIES
   bundler (>= 1.17)
+  guard
+  guard-rspec
   pry
   rake (>= 10.0)
   rspec (>= 3.0)

data/Guardfile

@@ -0,0 +1,36 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+## Uncomment and set this to only include directories you want to watch
+# directories %w(app lib config test spec features) \
+#  .select{|d| Dir.exists?(d) ? d : UI.warning("Directory #{d} does not exist")}
+
+## Note: if you are using the `directories` clause above and you are not
+## watching the project directory ('.'), then you will want to move
+## the Guardfile to a watched dir and symlink it back, e.g.
+#
+#  $ mkdir config
+#  $ mv Guardfile config/
+#  $ ln -s config/Guardfile .
+#
+# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
+guard :rspec, cmd: "bundle exec rspec" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # Feel free to open issues for suggestions and improvements
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+
+
+  # watch(rails.routes)          { "#{rspec.spec_dir}/routing" }
+  # watch(rails.app_controller)  { "#{rspec.spec_dir}/controllers" }
+end

data/README.md

@@ -3,7 +3,7 @@
 
 # Typerb
 
-Proof of concept type-checking library for Ruby 2.6.
+Proof of concept type-checking library for Ruby 2.6. Works with previous versions too with some limitation (see below).
 
 ```ruby
 class A
@@ -12,9 +12,15 @@ class A
   def call(some_arg)
     some_arg.type!(String, Symbol)
   end
+
+  def call_with_respond_checks(some_arg)
+    some_arg.respond_to!(:strip)
+  end
+
 end
 
 A.new.call(1) #=> TypeError: `some_arg` should be String or Symbol, not Integer
+A.new.call_with_respond_checks(1) #=> TypeError: 'Integer should respond to all methods: strip'
 ```
 
 This is equivalent to:
@@ -23,6 +29,10 @@ class A
   def call(some_arg)
     raise TypeError, "`some_arg` should be String or Symbol, not #{some_arg.class}" unless [String, Symbol].include?(some_arg.class)
   end
+
+  def call_with_respond_checks(some_arg)
+    raise TypeError, "#{some_arg.class} should respond to all methods: strip" unless [:strip].all{|meth| some_arg.respond_to?(meth)}
+  end
 end
 ```
 
@@ -90,13 +100,13 @@ end
 
 If you're unfamiliar with `using` keyword - this is refinement - a relatively new feature in Ruby (since 2.0). It's kind of monkey-patch, but with strict scope. Learn more about [refinements](https://ruby-doc.org/core-2.5.3/doc/syntax/refinements_rdoc.html).
 
-This refinement adds `type!()` method to `Object` class so you can call it on almost much any object (except those inherited from `BasicObject`, but these are rare).
+This refinement adds `type!()` and `not_nil!` methods to `Object` class so you can call it on almost much any object (except those inherited from `BasicObject`, but these are rare).
 
 The method will raise an exception if `self` is not an instance of one of the classes passed as arguments. The tricky part, however, is to get the variable name on which it's called. You need this to get a nice error message telling you exactly which variable has wrong type, not just an abstract `TypeError`. That's why we need Ruby 2.6 with its new `RubyVM::AST` (https://ruby-doc.org/core-2.6.0.preview3/RubyVM/AST.html).
 
 ## Limitations
 
-It requires Ruby 2.6.0-preview3. Relies on `RubyVM::AST` which may change in release version. So, expect breaking changes in Ruby.
+Full functionality Ruby 2.6.0-preview3. Relies on `RubyVM::AST` which may change in release version. So, expect breaking changes in Ruby. Previous versions also supported, but without variable name in exception message.
 
 Known limitations:
 
@@ -107,8 +117,9 @@ class A
 
   def call(some_arg)
     some_arg.
-            type!(String) # this won't work. type!() call must be on the same line with the variable it's called on - raise error message without variable name
-                          # some_arg.    type!(String) is ok though
+            type!(String)
+    # this won't work. type!() call must be on the same line with the variable it's called on - raise error message without variable name
+    # some_arg.    type!(String) is ok though
   end
 end
 ```
@@ -119,10 +130,11 @@ end
 [1] pry(main)*   using Typerb
 [1] pry(main)*   def call(a)
 [1] pry(main)*     a.type!(Hash)
-[1] pry(main)*   end  
-[1] pry(main)* end  
+[1] pry(main)*   end
+[1] pry(main)* end
 [2] pry(main)> A.new.call(1)
-TypeError: expected Hash, got Integer  # here we cannot get the source code for a line containing "a.type!(Hash)", so cannot see the variable name
+TypeError: expected Hash, got Integer
+# here we cannot get the source code for a line containing "a.type!(Hash)", so cannot see the variable name
 ```
 
 3. Multiple arguments on the same line:
@@ -131,7 +143,9 @@ class A
   using Typerb
 
   def initialize(arg1, arg2)
-    arg1.type!(Integer); arg2.type!(String) # no way to tell the variable - raise error message without variable name
+    arg1.type!(Integer); arg2.type!(String)
+    # no way to tell the variable - raise error message without variable name
+    # same error will be raised on Ruby < 2.6.0 because there is no RubyVM::AST
   end
 end
 ```

data/lib/typerb/exceptional.rb

@@ -6,6 +6,10 @@ module Typerb
       def klasses_text(klasses)
         klasses.size > 1 ? klasses.map(&:name).join(' or ') : klasses.first.name
       end
+
+      def methods_text(methods)
+        methods.join(', ')
+      end
     end
 
     def raise_with(backtrace, exception_text)

data/lib/typerb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Typerb
-  VERSION = '0.1.6'
+  VERSION = '0.1.7'
 end

data/lib/typerb.rb

@@ -31,5 +31,19 @@ module Typerb
 
       Typerb::Exceptional.new.raise_with(caller, exception_text)
     end
+
+    def respond_to!(*methods)
+      raise ArgumentError, 'provide at least one method' if methods.empty?
+      return self if methods.all? { |meth| respond_to?(meth) }
+
+      methods_text = Typerb::Exceptional.methods_text(methods)
+      exception_text = if (var_name = Typerb::VariableName.new(caller_locations(1, 1)).get)
+                         "#{self.class} (`#{var_name}`) should respond to all methods: #{methods_text}"
+                       else
+                         "#{self.class} should respond to all methods: #{methods_text}"
+                       end
+
+      Typerb::Exceptional.new.raise_with(caller, exception_text)
+    end
   end
 end

data/typerb.gemspec

@@ -25,6 +25,8 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_development_dependency 'bundler', '>= 1.17'
+  spec.add_development_dependency 'guard'
+  spec.add_development_dependency 'guard-rspec'
   spec.add_development_dependency 'pry'
   spec.add_development_dependency 'rake', '>= 10.0'
   spec.add_development_dependency 'rspec', '>= 3.0'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: typerb
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Oleg Antonyan
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-11-13 00:00:00.000000000 Z
+date: 2018-11-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -24,6 +24,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.17'
+- !ruby/object:Gem::Dependency
+  name: guard
+  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: guard-rspec
+  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
   requirement: !ruby/object:Gem::Requirement
@@ -109,6 +137,7 @@ files:
 - CODE_OF_CONDUCT.md
 - Gemfile
 - Gemfile.lock
+- Guardfile
 - LICENSE.txt
 - README.md
 - Rakefile