debugging 1.0.0 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f540cf321629826fd4539a2460b2b42f91726eec
-  data.tar.gz: 96bade08c3b33fd008c6057f4e0c0abd40c2f133
+SHA256:
+  metadata.gz: e4ec121a21a63ab0420e7c1aaa05cb7f12fd6269090a7ab8d177fbdb630ca7a0
+  data.tar.gz: 8f120206703e54307826c9d293f6f14379f9b4e2f7673a05ddf93d113a940e6f
 SHA512:
-  metadata.gz: 525abd17e17c032113e739150b84f390c98c71b5e7ce4c1f03773aa879ca117d43006150b0a146206011e83e4c9b3a0c21785b847b73daddd2b5d0018ed693b9
-  data.tar.gz: f11f34f6d50cb16bc4be14890fd9ba6aa98bcdc84f92eeb0b916c3e5f713a0c5dbe45c5055f4798d2c4dd0ae4f136c79efdc9bfb70fd9378c6f8791a05e7fcc1
+  metadata.gz: b3840c3a53afdf18f074086ee5fa628887f0176284edb371c752600140f78617b611dddc05d76a6a9b17e4eaadb819d039c1f4aa90401009babbd0de1a9a6e5f
+  data.tar.gz: b2b295c4a739ac963d881fffdcbdda265c59025b45389a5a96faa59f1ae894a9599b9746016b2f72960c2101e1579cd12a5d7c6ad0fae7e7312482da79b5f527

data/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{md,rdoc,txt}]
+indent_size = 4
+

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 conduct@janlelis.com. 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/ChangeLog.md

@@ -0,0 +1,50 @@
+## ChangeLog
+
+### 1.1.2 / 2020-12-29
+
+* Relax required Ruby version
+
+### 1.1.1 / 2017-03-18
+
+* Make howtocall private
+* Relax paint dependency (allow paint versions 2.x)
+
+### 1.1.0 / 2015-03-26
+
+* Added:
+  * howtocall
+* Change output from `mof`, now only returns singleton methods per module for modules
+* Make q compatible with paint ~> 1.0
+* Drop support for Ruby 1
+
+
+### 1.0.2 / 2015-01-24
+
+* Bump binding.repl version
+
+
+### 1.0.1 / 2014-02-15
+
+* Bump binding.repl version
+
+
+### 1.0.0 / 2014-01-19
+
+* Adjusted concept: Only helper method style
+* Removed:
+  * dd
+  * binding.vars
+
+* Added:
+  * beep
+  * repl
+
+* Renamed:
+  * oo -> at
+  * cc -> callstack
+  * mm -> mof
+  * regexp_visualize -> re
+
+* Method List: Display all available ancestors by default and add third argument for grepping
+* Moved from zucker 13.1 gem into its own gem
+

data/Gemfile

@@ -5,7 +5,3 @@ gemspec
 group :full_support do
   gem 'binding_of_caller'
 end
-
-platform :rbx do
-  gem 'rubysl-singleton'
-end

data/{LICENSE.txt → MIT-LICENSE.txt}

@@ -1,4 +1,4 @@
-Copyright (c) 2014 Jan Lelis
+Copyright (c) 2010-2020 Jan Lelis
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,173 @@
+# Ruby Print Debugging [![version](https://badge.fury.io/rb/debugging.svg)](https://badge.fury.io/rb/debugging) [<img src="https://github.com/janlelis/debugging/workflows/Test/badge.svg" />](https://github.com/janlelis/debugging/actions?query=workflow%3ATest)
+
+Helps you to introspect and debug your code.
+
+
+## Setup
+
+Install gem:
+
+```
+$ gem install debugging binding_of_caller
+```
+
+
+In Ruby:
+
+```ruby
+require 'debugging/all'
+```
+
+Instead of requiring all, you can also require only one function, e.g:
+
+```ruby
+require 'debugging/q'
+```
+
+In a bundler project, you will need to add the gem to your project's `Gemfile`:
+
+```ruby
+gem 'debugging', require: 'debugging/all'
+gem 'binding_of_caller'
+```
+
+## Methods
+### at(label = nil)
+
+Prints out that a specific point in a script has been reached.
+
+```
+[label] @ method `...', line ... of file ....
+```
+
+### beep
+
+Lets your terminal bell ring.
+
+### callstack
+
+Prints out your current callstack. For example:
+
+```
+<main>
+  start
+    catch
+      block in start
+        eval_input
+          each_top_level_statement
+            catch
+              block in each_top_level_statement
+                loop
+                  block (2 levels) in each_top_level_statement
+                    block in eval_input
+                      signal_status
+                        block (2 levels) in eval_input
+                          evaluate
+                            evaluate
+                              eval
+                                irb_binding
+```
+
+### howtocall(obj = self, method_or_proc)
+
+Displays parameter names and types for a proc or method (identified by a symbol):
+
+```ruby
+def function(a, b = 3, &c)
+end
+howtocall :function #=> function(a, b, &c)
+```
+
+What is not visible in the example above: All optional parameters are displayed underlined.
+
+If you want to access a function that is defined on an other object than the current one,
+you can pass it as an optional parameter:
+
+```ruby
+howtocall FileUtils, :cd #=> cd(dir, options, &block)
+howtocall Open3, :popen3 #=> popen3(*cmd, **opts, &block)
+
+```
+
+An example with lambdas and keyword arguments:
+
+```ruby
+a = ->(filter: /\A.*\z/, string:){ string[filter] }
+howtocall a #=> call(string:, filter:)
+```
+
+
+### mof(obj, depth = nil)
+
+"Methods of": Prints out available methods, ordered by modules:
+
+```ruby
+mof [1,2,3]
+```
+
+```
+###
+Eigenclass
+
+Array
+inspect  to_s  to_a  to_h  to_ary  frozen?  ==  eql?  hash  []  []=  at  fet
+ch  first  last  concat  <<  push  pop  shift  unshift  insert  each  each_i
+ndex  reverse_each  length  size  empty?  find_index  index  rindex  join  r
+everse  reverse!  rotate  rotate!  sort  sort!  sort_by!  collect  collect!
+ map  map!  select  select!  keep_if  values_at  delete  delete_at  delete_i
+f  reject  reject!  zip  transpose  replace  clear  fill  include?  <=>  sli
+ce  slice!  assoc  rassoc  +  *  -  &  |  uniq  uniq!  compact  compact!  fl
+atten  flatten!  count  shuffle!  shuffle  sample  cycle  permutation  combi
+nation  repeated_permutation  repeated_combination  product  take  take_whil
+e  drop  drop_while  bsearch  pack
+
+Enumerable
+to_a  entries  to_h  sort  sort_by  grep  count  find  detect  find_index  f
+ind_all  select  reject  collect  map  flat_map  collect_concat  inject  red
+uce  partition  group_by  first  all?  any?  one?  none?  min  max  minmax
+min_by  max_by  minmax_by  member?  include?  each_with_index  reverse_each
+ each_entry  each_slice  each_cons  each_with_object  zip  take  take_while
+ drop  drop_while  cycle  chunk  slice_before  lazy
+
+Object
+
+Debugging
+
+Kernel
+nil?  ===  =~  !~  eql?  hash  <=>  class  singleton_class  clone  dup  tain
+t  tainted?  untaint  untrust  untrusted?  trust  freeze  frozen?  to_s  ins
+pect  methods  singleton_methods  protected_methods  private_methods  public
+_methods  instance_variables  instance_variable_get  instance_variable_set
+instance_variable_defined?  remove_instance_variable  instance_of?  kind_of?
+  is_a?  tap  send  public_send  respond_to?  extend  display  method  publi
+c_method  singleton_method  define_singleton_method  object_id  to_enum  enu
+m_for
+
+BasicObject
+==  equal?  !  !=  instance_eval  instance_exec  __send__  __id__
+```
+
+### q(*args)
+
+Like `Kernel#p`, but with colors on one line:
+
+```ruby
+q :is_like, ?p, "but on one line"
+```
+
+### re(string, regex, groups = nil)
+
+Assists you when matching regexes againts strings. Try this one:
+
+```ruby
+re "mail@janlelis.de", /\b([A-Z0-9._%+-]+)@([A-Z0-9.-]+\.[A-Z]{2,10})\b/i, 0..2
+```
+
+### repl
+
+Starts your favorite IRB session from the current binding.
+
+## J-_-L
+
+Copyright (c) 2010-2020 Jan Lelis. MIT License. Originated from the
+[zucker](https://github.com/janlelis/sugar_refinery) gem.

data/Rakefile

@@ -1,33 +1,37 @@
-# encoding: utf-8
+# # #
+# Get gemspec info
+
+gemspec_file = Dir['*.gemspec'].first
+gemspec = eval File.read(gemspec_file), binding, gemspec_file
+info = "#{gemspec.name} | #{gemspec.version} | " \
+       "#{gemspec.runtime_dependencies.size} dependencies | " \
+       "#{gemspec.files.size} files"
+
+
+# # #
+# Gem build and install task
+
+desc info
+task :gem do
+  puts info + "\n\n"
+  print "  "; sh "gem build #{gemspec_file}"
+  FileUtils.mkdir_p 'pkg'
+  FileUtils.mv "#{gemspec.name}-#{gemspec.version}.gem", 'pkg'
+  puts; sh %{gem install --no-document pkg/#{gemspec.name}-#{gemspec.version}.gem}
+end
 
-require 'rubygems'
 
-begin
-  require 'bundler'
-rescue LoadError => e
-  warn e.message
-  warn "Run `gem install bundler` to install Bundler."
-  exit -1
-end
+# # #
+# Start an IRB session with the gem loaded
 
-begin
-  Bundler.setup(:development)
-rescue Bundler::BundlerError => e
-  warn e.message
-  warn "Run `bundle install` to install missing gems."
-  exit e.status_code
+desc "#{gemspec.name} | IRB"
+task :irb do
+  sh "irb -I ./lib -r #{gemspec.name.gsub '-','/'}"
 end
 
-require 'rake'
 
-require 'rubygems/tasks'
-Gem::Tasks.new
-
-require 'rdoc/task'
-RDoc::Task.new do |rdoc|
-  rdoc.title = "ruby_version"
-end
-task :doc => :rdoc
+# # #
+# Spec
 
 require 'rspec/core/rake_task'
 RSpec::Core::RakeTask.new

data/debugging.gemspec

@@ -5,24 +5,24 @@ require File.expand_path('../lib/debugging/version', __FILE__)
 Gem::Specification.new do |gem|
   gem.name          = "debugging"
   gem.version       = Debugging::VERSION
-  gem.summary       = 'Print debugging helpers.'
-  gem.description   = 'Provides useful print debugging helpers.'
+  gem.summary       = 'Print debugging helpers'
+  gem.description   = 'Utilities for better "print debugging"'
   gem.license       = "MIT"
   gem.authors       = ["Jan Lelis"]
-  gem.email         = "mail@janlelis.de"
+  gem.email         = ["hi@ruby.consulting"]
   gem.homepage      = "https://github.com/janlelis/debugging"
 
-  gem.files         = Dir['{**/}{.*,*}'].select { |path| File.file?(path) }
+  gem.files         = Dir['{**/}{.*,*}'].select { |path| File.file?(path) && path !~ /pkg/ }
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ['lib']
 
-  gem.add_dependency 'paint', '~> 0', '>= 0.8.7'
-  gem.add_dependency 'binding.repl', '~> 0'
+  gem.required_ruby_version = '>= 2.0', '< 4.0'
+
+  gem.add_dependency 'paint', '>= 0.9', '< 3.0'
+  gem.add_dependency 'binding.repl', '~> 3.0'
 
-  gem.add_development_dependency 'bundler', '~> 1.0'
   gem.add_development_dependency 'rake', '~> 10.1'
   gem.add_development_dependency 'rdoc', '~> 3.0'
   gem.add_development_dependency 'rspec', '~> 2.4'
-  gem.add_development_dependency 'rubygems-tasks', '~> 0.2'
 end

data/lib/debugging/howtocall.rb

@@ -0,0 +1,36 @@
+require 'debugging'
+
+module Debugging
+  private
+
+  def howtocall(object = self, method_or_proc)
+    if method_or_proc.is_a? Proc
+      params = method_or_proc.parameters
+      template = "call(%s)"
+    else
+      unless method_or_proc.is_a?(Method) || method_or_proc.is_a?(UnboundMethod)
+        method_or_proc = object.method(method_or_proc)
+      end
+      params = method_or_proc.parameters
+      template = "#{method_or_proc.name}(%s)"
+    end
+
+    sig = params.map{ |type, name|
+      param = ""
+      param << "*" if type == :rest
+      param << "**" if type == :keyrest
+      param << "&" if type == :block
+      name = ?? if !name && !(type == :rest || type == :keyrest)
+      if type == :opt || type == :key
+        param << Paint[name, :underline]
+      else
+        param << name.to_s
+      end
+      param << ":" if type == :key || type == :keyreq
+      param
+    }*", "
+
+    puts template %(sig)
+    nil
+  end
+end

data/lib/debugging/mof.rb

@@ -3,27 +3,28 @@ require 'debugging'
 module Debugging
   private
 
-  def mof(obj, depth = nil, grep_for = //)
-    grep_for = Regexp.new(grep_for)
+  def mof(obj, depth = nil, grep = //)
+    grep = Regexp.new(grep)
     puts Paint["###", :red, :bold]
 
-    eigen_methods = obj.singleton_methods.grep(grep_for)
-    if eigen_methods.empty?
-      puts Paint['Eigenclass', :yellow]
-    else
-      puts Paint['Eigenclass', :green, :underline], eigen_methods.map(&:to_s)*'  '
-    end
-    puts
-
     if obj.is_a? Module
-      klass, method_function = obj, :public_methods
+      klass, method_function = obj, :singleton_methods
+      depth += 1 if depth
     else
       klass, method_function = obj.class, :public_instance_methods
+
+      eigen_methods = obj.singleton_methods.grep(grep)
+      if eigen_methods.empty?
+        puts Paint['Eigenclass', :yellow]
+      else
+        puts Paint['Eigenclass', :green, :underline], eigen_methods.map(&:to_s)*'  '
+      end
+      puts
     end
 
     (depth || klass.ancestors.size).times{ |level|
       if cur = klass.ancestors[level]
-        level_methods = cur.send(method_function, false).grep(grep_for)
+        level_methods = cur.send(method_function, false).grep(grep)
         colors = level_methods.empty? ? [:yellow] : [:green, :underline]
         puts Paint["#{cur}", *colors], level_methods.map(&:to_s)*'  '
         puts unless level_methods.empty?

data/lib/debugging/q.rb

@@ -4,6 +4,6 @@ module Debugging
   private
 
   def q(*args)
-    puts args.map{ |e| Paint[e.inspect, :random] }*'  ' unless args.empty?
+    puts args.map{ |e| Paint[e.inspect, Paint.random] }*'  ' unless args.empty?
   end
 end

data/lib/debugging/version.rb

@@ -1,3 +1,3 @@
 module Debugging
-  VERSION = "1.0.0"
+  VERSION = "1.1.2".freeze
 end

data/spec/howtocall_spec.rb

@@ -0,0 +1,74 @@
+require 'spec_helper'
+require 'debugging/howtocall'
+
+describe "howtocall" do
+  it "displays method parameters" do
+    def function(a, b)
+    end
+
+    expect( capture_stdout{ howtocall :function } ).to eq "function(a, b)\n"
+  end
+
+  it "underlines optional parameters" do
+    def function(a, b = 3)
+    end
+
+    expect( capture_stdout{ howtocall :function } ).to eq "function(a, \e[4mb\e[0m)\n"
+  end
+
+  it "shows block parameters" do
+    def function(a, &b)
+    end
+
+    expect( capture_stdout{ howtocall :function } ).to eq "function(a, &b)\n"
+  end
+
+  it "optionally takes an object where the method shoud be looked for (if not self)" do
+    module Klass
+      def self.function(a,b)
+      end
+    end
+
+    expect( capture_stdout{ howtocall Klass, :function } ).to eq "function(a, b)\n"
+  end
+
+  it "appends : for keyword arguments" do
+    def function(a: 42, b: 43)
+    end
+
+    expect( capture_stdout{ howtocall :function } ).to eq "function(\e[4ma\e[0m:, \e[4mb\e[0m:)\n"
+  end
+
+  it "shows *splats and keyword **splats" do
+    def function(*cmd, **opts)
+    end
+
+    expect( capture_stdout{ howtocall :function } ).to eq "function(*cmd, **opts)\n"
+  end
+
+  it "shows ? for array deconstructor parameters" do
+    def function((a, b))
+    end
+
+    expect( capture_stdout{ howtocall :function } ).to eq "function(?)\n"
+  end
+
+  it "also works for procs" do
+    lambda = ->(a, b){}
+
+    expect( capture_stdout{ howtocall lambda } ).to eq "call(a, b)\n"
+  end
+
+  if RUBY_ENGINE == "ruby" || RUBY_ENGINE == "jruby"
+    context "[native methods]" do
+      it "shows ? instead of parameter names for fixed amount of parameters" do
+        expect( capture_stdout{ howtocall :is_a? } ).to eq "is_a?(?)\n"
+      end
+
+      it "shows * instead of parameters for variable amount of parameters" do
+        expect( capture_stdout{ howtocall :puts } ).to eq "puts(*)\n"
+      end
+    end
+  end
+
+end

data/spec/q_spec.rb

@@ -2,18 +2,20 @@ require 'spec_helper'
 require 'debugging/q'
 
 describe 'q' do
-  it 'should output the same as p for a single arg' do
-    Paint.unpaint(capture_stdout{q /some object/}).should ==
-    capture_stdout{p /some object/}
+  it "should output the same as p for a single arg" do
+    expect(
+      Paint.unpaint(capture_stdout{q /some object/})
+    ).to eq capture_stdout{p /some object/}
   end
 
   it "should output the same as p but for multiple args one one line, values separated by two spaces" do
-    Paint.unpaint(capture_stdout do
-      q 1, "1", 2..5, [], {:hallo => :du}, nil, true
-    end).chop.should ==
-    capture_stdout do
+    expect(
+      Paint.unpaint(capture_stdout{
+        q 1, "1", 2..5, [], {:hallo => :du}, nil, true
+      }
+    ).chop ).to eq capture_stdout{
       p 1, "1", 2..5, [], {:hallo => :du}, nil, true
-    end.chop.gsub( "\n", '  ' )
+    }.chop.gsub( "\n", '  ' )
   end
 end
 

metadata

@@ -1,63 +1,49 @@
 --- !ruby/object:Gem::Specification
 name: debugging
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.2
 platform: ruby
 authors:
 - Jan Lelis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-19 00:00:00.000000000 Z
+date: 2020-12-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: paint
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.7
+        version: '0.9'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.7
+        version: '0.9'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: binding.repl
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -100,34 +86,22 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.4'
-- !ruby/object:Gem::Dependency
-  name: rubygems-tasks
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-description: Provides useful print debugging helpers.
-email: mail@janlelis.de
+description: Utilities for better "print debugging"
+email:
+- hi@ruby.consulting
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".editorconfig"
 - ".gitignore"
 - ".rspec"
-- ".travis.yml"
-- ChangeLog.rdoc
+- CODE_OF_CONDUCT.md
+- ChangeLog.md
 - Gemfile
 - Gemfile.lock
-- LICENSE.txt
-- README.rdoc
+- MIT-LICENSE.txt
+- README.md
 - Rakefile
 - debugging.gemspec
 - lib/debugging.rb
@@ -135,11 +109,13 @@ files:
 - lib/debugging/at.rb
 - lib/debugging/beep.rb
 - lib/debugging/callstack.rb
+- lib/debugging/howtocall.rb
 - lib/debugging/mof.rb
 - lib/debugging/q.rb
 - lib/debugging/re.rb
 - lib/debugging/repl.rb
 - lib/debugging/version.rb
+- spec/howtocall_spec.rb
 - spec/q_spec.rb
 - spec/re_spec.rb
 - spec/spec_helper.rb
@@ -155,19 +131,22 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.0'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: '4.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.2.1
+rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
-summary: Print debugging helpers.
+summary: Print debugging helpers
 test_files:
+- spec/howtocall_spec.rb
 - spec/q_spec.rb
 - spec/re_spec.rb
 - spec/spec_helper.rb

data/.travis.yml

@@ -1,13 +0,0 @@
-language: ruby
-
-rvm:
-- ruby-head
-- 2.1.0
-- 2.0.0
-- 1.9.3
-- 1.9.2
-- jruby
-- jruby-19mode
-- rbx
-
-bundler_args: --without full_support

data/ChangeLog.rdoc

@@ -1,17 +0,0 @@
-=== 1.0.0 / 2014-01-19
-
-* Adjusted concept: Only helper method style
-* Removed:
-  * dd
-  * binding.vars
-* Added:
-  * beep
-  * repl
-* Renamed:
-  * oo -> at
-  * cc -> callstack
-  * mm -> mof
-  * regexp_visualize -> re
-* Method List: Display all available ancestors by default and add third argument for grepping
-* Moved from zucker 13.1 gem into its own gem
-

data/README.rdoc

@@ -1,102 +0,0 @@
-= Ruby Print Debugging {<img src="https://travis-ci.org/janlelis/debugging.png" />}[https://travis-ci.org/janlelis/debugging]
-
-
-== Setup
-
-    $ gem install debugging binding_of_caller
-
-
-Or in your Gemfile:
-
-    gem 'debugging'
-    gem 'binding_of_caller'
-
-
-In Ruby:
-
-    require 'debugging/all'
-
-
-== Methods
-
-=== at(label = nil)
-
-    [label] @ method `...', line ... of file ....
-
-
-=== beep
-
-    Lets your terminal bell ring.
-
-
-=== callstack
-
-    <main>
-      start
-        catch
-          block in start
-            eval_input
-              each_top_level_statement
-                catch
-                  block in each_top_level_statement
-                    loop
-                      block (2 levels) in each_top_level_statement
-                        block in eval_input
-                          signal_status
-                            block (2 levels) in eval_input
-                              evaluate
-                                evaluate
-                                  eval
-                                    irb_binding
-
-
-=== mof(obj, depth = nil)
-
-Methods of:
-
-    >> mof [1,2,3]
-    ###
-    Eigenclass
-
-    Array
-    inspect  to_s  to_a  to_h  to_ary  frozen?  ==  eql?  hash  []  []=  at  fetch  first  last  concat  <<  push  pop  shift  unshift  insert  each  each_index  reverse_each  length  size  empty?  find_index  index  rindex  join  reverse  reverse!  rotate  rotate!  sort  sort!  sort_by!  collect  collect!  map  map!  select  select!  keep_if  values_at  delete  delete_at  delete_if  reject  reject!  zip  transpose  replace  clear  fill  include?  <=>  slice  slice!  assoc  rassoc  +  *  -  &  |  uniq  uniq!  compact  compact!  flatten  flatten!  count  shuffle!  shuffle  sample  cycle  permutation  combination  repeated_permutation  repeated_combination  product  take  take_while  drop  drop_while  bsearch  pack
-
-    Enumerable
-    to_a  entries  to_h  sort  sort_by  grep  count  find  detect  find_index  find_all  select  reject  collect  map  flat_map  collect_concat  inject  reduce  partition  group_by  first  all?  any?  one?  none?  min  max  minmax  min_by  max_by  minmax_by  member?  include?  each_with_index  reverse_each  each_entry  each_slice  each_cons  each_with_object  zip  take  take_while  drop  drop_while  cycle  chunk  slice_before  lazy
-
-    Object
-
-    Debugging
-
-    Kernel
-    nil?  ===  =~  !~  eql?  hash  <=>  class  singleton_class  clone  dup  taint  tainted?  untaint  untrust  untrusted?  trust  freeze  frozen?  to_s  inspect  methods  singleton_methods  protected_methods  private_methods  public_methods  instance_variables  instance_variable_get  instance_variable_set  instance_variable_defined?  remove_instance_variable  instance_of?  kind_of?  is_a?  tap  send  public_send  respond_to?  extend  display  method  public_method  singleton_method  define_singleton_method  object_id  to_enum  enum_for
-
-    BasicObject
-    ==  equal?  !  !=  instance_eval  instance_exec  __send__  __id__
-
-
-=== q(*args)
-
-    q :is_like, ?p, "but on one line"
-
-
-=== re(string, regex, groups = nil)
-
-An utility to assist you matching regexes againts strings. Try this one:
-
-    >> re "mail@janlelis.de", /\b([A-Z0-9._%+-]+)@([A-Z0-9.-]+\.[A-Z]{2,10})\b/i, 0..2
-
-
-=== repl
-
-    Starts your favorite IRB session.
-
-
-== Also See
-
-https://github.com/davejacobs/letters
-
-
-== J-_-L
-
-Copyright (c) 2010-2014 Jan Lelis. MIT License. Originated from the zucker gem.