debug_helper 1.8.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b96c161aefd3636445bc0a68e63f815057037060
-  data.tar.gz: 9c6de8c9b4f3d358d404a60437a5a4ccbda7894e
+  metadata.gz: 51525f61840672b3952396ecdd6c3ae0fa3d295d
+  data.tar.gz: df5651cf40374d2c92997bf35405ba547cf4c949
 SHA512:
-  metadata.gz: dd4ff02ad1a77f4c2163cabd5d02c6cee83d6570e2ae2ef33bb674ac984a94ccf994f4307ddc1762df288edcae77aa0543e21b437e4e55a50bcc36f9438fbc70
-  data.tar.gz: bdca4596038096b29f17a7e82c4f4488af737f50c23a50f3d7ae20ab7d2cfc84c2f708cd660c66b12bbdba0fa2eacbac28c20ebafbe9d24f2c7442386031107b
+  metadata.gz: 08d951eb328c33275490c86acf4f3332ca4e71c456a60d52ad5b0abc34804d8bb17258ef0207e05d0b5cdd0f88a5970263ba32e8c993f602f4cdb6a99b3fb7cf
+  data.tar.gz: dfea562f5ccbb2025430df32ac098bac73b231af0a59324fb51165a0a01d106776283a850e0689a5ffd82fc2679803b85279ef2c2db7596b346bd3674666ce1e

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    debug_helper (1.8.0)
+    debug_helper (2.0.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,15 +1,14 @@
 # Debug Helper
 
-## New in Version 1.8
+[![Gem](https://img.shields.io/gem/v/debug_helper.svg?style=flat)](http://rubygems.org/gems/debug_helper "View this project in Rubygems")
 
-Classes analyzed:
+## New in Version 2.0
 
-- [Dir](#dir)
-- [Exception](#exception)
-- [Range](#range)
-- [Regexp](#regexp)
-- [IO](#io)
-- [MatchData](#matchdata)
+Previously, ```debug_helper``` explicated objects for only certain classes in the Ruby core and standard library.
+
+This version supports custom explication of user-defined classes.  This means, in effect, that you can use ```debug_helper``` to explicate any classes you choose.
+
+See [Custom](#custom).
 
 ## About Debug Helper
 
@@ -60,6 +59,10 @@ Others are treated as:
 
 - [Object](#object)
 
+But wait, there's more!  For your own classes, you can create your own handlers:
+
+- [Custom](#custom)
+
 ## Class Method or Module Method?
 
 Most examples in this documentation show use of the class method:
@@ -99,7 +102,7 @@ The output shows details of the array.
 ```yaml
 ---
 Array (message='My simple array'):
-  size: 3
+  Array#size: 3
   Element 0: Fixnum 5
   Element 1: Fixnum 10
   Element 2: Fixnum 15
@@ -123,20 +126,20 @@ The output shows details of the array.
 ```yaml
 ---
 Array (message='My mixed array'):
-  size: 3
+  Array#size: 3
   Element 0: Fixnum 0
   Element 1:
     String:
-      to_s: one
-      size: 3
-      encoding: !ruby/encoding UTF-8
-      ascii_only?: true
-      bytesize: 3
+      String#to_s: one
+      String#size: 3
+      String#encoding: !ruby/encoding UTF-8
+      String#ascii_only?: true
+      String#bytesize: 3
   Element 2:
     Symbol:
-      to_s: two
-      size: 3
-      encoding: !ruby/encoding US-ASCII
+      Symbol#to_s: two
+      Symbol#size: 3
+      Symbol#encoding: !ruby/encoding US-ASCII
 ```
 
 #### Nested Arrays
@@ -157,16 +160,16 @@ The output shows details of the arrays.
 ```yaml
 ---
 Array (message='My nested arrays'):
-  size: 3
+  Array#size: 3
   Element 0: Fixnum 0
   Element 1:
     Array:
-      size: 2
+      Array#size: 2
       Element 0: Fixnum 1
       Element 1: Fixnum 2
   Element 2:
     Array:
-      size: 2
+      Array#size: 2
       Element 0: Fixnum 3
       Element 1: Fixnum 4
 ```
@@ -194,10 +197,10 @@ The circular reference is not followed.
 ```yaml
 ---
 Array (message='My circular arrays'):
-  size: 1
+  Array#size: 1
   Element 0:
     Array:
-      size: 1
+      Array#size: 1
       Element 0: Array [[[...]]]
 ```
 ### Dir
@@ -220,15 +223,15 @@ The output shows details of the ```Dir```.
 ```yaml
 ---
 Dir (message='My simple dir'):
-  path: "."
-  entries:
+  Dir#path: "."
+  Dir.entries("."):
   - "."
   - ".."
   - show.md
   - show.rb
   - show.yaml
   - template.md
-  exist?: true
+  Dir.exist?("."): true
 ```
 ### Exception
 
@@ -268,9 +271,9 @@ The output shows details of the ```Exception```.
 ```yaml
 ---
 Exception (message='My simple exception'):
-  message: Boo!
-  cause: 
-  backtrace:
+  Exception#message: Boo!
+  Exception#cause: 
+  Exception#backtrace:
   - show.rb:6:in `foo'
   - show.rb:14:in `bar'
   - show.rb:18:in `baz'
@@ -296,23 +299,23 @@ The output shows details of the file.
 ```yaml
 ---
 File (message='My simple file'):
-  absolute_path: C:/Users/Burdette/Documents/GitHub/debug_helper/markdown/readme/classes/file/simple/show.rb
-  atime: 2018-07-14 12:45:32.000000000 -05:00
-  ctime: 2018-07-14 12:45:32.000000000 -05:00
-  executable?: false
-  exist?: true
-  ftype: file
-  mtime: 2018-07-14 12:45:32.000000000 -05:00
-  path: show.rb
-  pipe?: false
-  readable?: true
-  realpath: C:/Users/Burdette/Documents/GitHub/debug_helper/markdown/readme/classes/file/simple/show.rb
-  setgid?: false
-  setuid?: false
-  size: 95
-  socket?: false
-  symlink?: false
-  writable?: true
+  File.absolute_path("show.rb"): C:/Users/Burdette/Documents/GitHub/debug_helper/markdown/readme/classes/file/simple/show.rb
+  File.atime("show.rb"): 2018-07-14 12:45:32.000000000 -05:00
+  File.ctime("show.rb"): 2018-07-14 12:45:32.000000000 -05:00
+  File.executable?("show.rb"): false
+  File.exist?("show.rb"): true
+  File.ftype("show.rb"): file
+  File.mtime("show.rb"): 2018-07-14 12:45:32.000000000 -05:00
+  File.path("show.rb"): show.rb
+  File.pipe?("show.rb"): false
+  File.readable?("show.rb"): true
+  File.realpath("show.rb"): C:/Users/Burdette/Documents/GitHub/debug_helper/markdown/readme/classes/file/simple/show.rb
+  File.setgid?("show.rb"): false
+  File.setuid?("show.rb"): false
+  File.size("show.rb"): 95
+  File.socket?("show.rb"): false
+  File.symlink?("show.rb"): false
+  File.writable?("show.rb"): true
 ```
 ### Hash
 
@@ -334,29 +337,29 @@ The output shows details of the hash.
 ```yaml
 ---
 Hash (message='My simple hash'):
-  size: 3
-  default: 
-  default_proc: 
+  Hash#size: 3
+  Hash#default: 
+  Hash#default_proc: 
   Pair 0:
     Key:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 0
   Pair 1:
     Key:
       Symbol:
-        to_s: b
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: b
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 1
   Pair 2:
     Key:
       Symbol:
-        to_s: c
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: c
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 2
 ```
 
@@ -382,40 +385,40 @@ The output shows details of the hash.
 ```yaml
 ---
 Hash (message='My mixed hash'):
-  size: 3
-  default: 
-  default_proc: 
+  Hash#size: 3
+  Hash#default: 
+  Hash#default_proc: 
   Pair 0:
     Key:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 0
   Pair 1:
     Key:
       Symbol:
-        to_s: b
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: b
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       String:
-        to_s: one
-        size: 3
-        encoding: !ruby/encoding UTF-8
-        ascii_only?: true
-        bytesize: 3
+        String#to_s: one
+        String#size: 3
+        String#encoding: !ruby/encoding UTF-8
+        String#ascii_only?: true
+        String#bytesize: 3
   Pair 2:
     Key:
       Symbol:
-        to_s: c
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: c
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       Symbol:
-        to_s: two
-        size: 3
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: two
+        Symbol#size: 3
+        Symbol#encoding: !ruby/encoding US-ASCII
 ```
 
 #### Nested Hashes
@@ -445,58 +448,58 @@ The output shows details of the hashes.
 ```yaml
 ---
 Hash (message='My nested hash'):
-  size: 2
-  default: 
-  default_proc: 
+  Hash#size: 2
+  Hash#default: 
+  Hash#default_proc: 
   Pair 0:
     Key:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       Hash:
-        size: 2
-        default: 
-        default_proc: 
+        Hash#size: 2
+        Hash#default: 
+        Hash#default_proc: 
         Pair 0:
           Key:
             Symbol:
-              to_s: b
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: b
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 0
         Pair 1:
           Key:
             Symbol:
-              to_s: c
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: c
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 1
   Pair 1:
     Key:
       Symbol:
-        to_s: d
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: d
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       Hash:
-        size: 2
-        default: 
-        default_proc: 
+        Hash#size: 2
+        Hash#default: 
+        Hash#default_proc: 
         Pair 0:
           Key:
             Symbol:
-              to_s: e
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: e
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 2
         Pair 1:
           Key:
             Symbol:
-              to_s: f
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: f
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 3
 ```
 
@@ -523,26 +526,26 @@ The circular reference is not followed.
 ```yaml
 ---
 Hash (message='My circular hashes'):
-  size: 1
-  default: 
-  default_proc: 
+  Hash#size: 1
+  Hash#default: 
+  Hash#default_proc: 
   Pair 0:
     Key:
       Symbol:
-        to_s: foo
-        size: 3
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: foo
+        Symbol#size: 3
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       Hash:
-        size: 1
-        default: 
-        default_proc: 
+        Hash#size: 1
+        Hash#default: 
+        Hash#default_proc: 
         Pair 0:
           Key:
             Symbol:
-              to_s: bar
-              size: 3
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: bar
+              Symbol#size: 3
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Hash {:foo=>{:bar=>{...}}}
 ```
 ### IO
@@ -565,10 +568,10 @@ The output shows details of the ```IO```.
 ```yaml
 ---
 IO (message='My simple io'):
-  autoclose?: true
-  binmode?: false
-  closed?: false
-  tty?: false
+  IO#autoclose?: true
+  IO#binmode?: false
+  IO#closed?: false
+  IO#tty?: false
 ```
 ### MatchData
 
@@ -590,12 +593,12 @@ The output shows details of the ```MatchData```.
 ```yaml
 ---
 MatchData (message='My simple MatchData'):
-  size: 1
-  regexp: !ruby/regexp /[a-z]/
-  to_a:
+  MatchData#size: 1
+  MatchData#regexp: !ruby/regexp /[a-z]/
+  MatchData#to_a:
   - a
-  captures: []
-  names: []
+  MatchData#captures: []
+  MatchData#names: []
 ```
 
 #### Multiple Captures
@@ -616,20 +619,20 @@ The output shows details of the ```MatchData```.
 ```yaml
 ---
 MatchData (message='My MatchData with named captures'):
-  size: 5
-  regexp: !ruby/regexp /(.)(.)(\d+)(\d)/
-  to_a:
+  MatchData#size: 5
+  MatchData#regexp: !ruby/regexp /(.)(.)(\d+)(\d)/
+  MatchData#to_a:
   - HX1138
   - H
   - X
   - '113'
   - '8'
-  captures:
+  MatchData#captures:
   - H
   - X
   - '113'
   - '8'
-  names: []
+  MatchData#names: []
 ```
 
 #### Named Captures
@@ -650,16 +653,16 @@ The output shows details of the ```MatchData```.
 ```yaml
 ---
 MatchData (message='My MatchData with named captures'):
-  size: 3
-  regexp: !ruby/regexp /(?<x>.)(?<y>.)?/
-  to_a:
+  MatchData#size: 3
+  MatchData#regexp: !ruby/regexp /(?<x>.)(?<y>.)?/
+  MatchData#to_a:
   - a
   - a
   - 
-  captures:
+  MatchData#captures:
   - a
   - 
-  names:
+  MatchData#names:
   - x
   - y
 ```
@@ -687,23 +690,23 @@ OpenStruct (message='My simple struct'):
   Member 0:
     Name:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 0
   Member 1:
     Name:
       Symbol:
-        to_s: b
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: b
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 1
   Member 2:
     Name:
       Symbol:
-        to_s: c
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: c
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 2
 ```
 
@@ -729,34 +732,34 @@ OpenStruct (message='My mixed open struct'):
   Member 0:
     Name:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 0
   Member 1:
     Name:
       Symbol:
-        to_s: b
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: b
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       String:
-        to_s: one
-        size: 3
-        encoding: !ruby/encoding UTF-8
-        ascii_only?: true
-        bytesize: 3
+        String#to_s: one
+        String#size: 3
+        String#encoding: !ruby/encoding UTF-8
+        String#ascii_only?: true
+        String#bytesize: 3
   Member 2:
     Name:
       Symbol:
-        to_s: c
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: c
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       Symbol:
-        to_s: two
-        size: 3
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: two
+        Symbol#size: 3
+        Symbol#encoding: !ruby/encoding US-ASCII
 ```
 
 #### Nested OpenStructs
@@ -790,46 +793,46 @@ OpenStruct (message='My nested struct'):
   Member 0:
     Name:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       OpenStruct:
         Member 0:
           Name:
             Symbol:
-              to_s: b
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: b
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 0
         Member 1:
           Name:
             Symbol:
-              to_s: c
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: c
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 1
   Member 1:
     Name:
       Symbol:
-        to_s: d
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: d
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       OpenStruct:
         Member 0:
           Name:
             Symbol:
-              to_s: e
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: e
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 2
         Member 1:
           Name:
             Symbol:
-              to_s: f
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: f
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 3
 ```
 
@@ -860,17 +863,17 @@ OpenStruct (message='My circular ostruct'):
   Member 0:
     Name:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       OpenStruct:
         Member 0:
           Name:
             Symbol:
-              to_s: a
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: a
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: 'OpenStruct #<OpenStruct a=#<OpenStruct a=#<OpenStruct ...>>>'
 ```
 ### Range
@@ -893,9 +896,9 @@ The output shows details of the ```Range```.
 ```yaml
 ---
 Range (message='My inclusive range'):
-  first: 0
-  last: 4
-  exclude_end?: false
+  Range#first: 0
+  Range#last: 4
+  Range#exclude_end?: false
 ```
 
 #### Exclusive Range
@@ -916,9 +919,9 @@ The output shows details of the ```Range```.
 ```yaml
 ---
 Range (message='My exclusive range'):
-  first: 0
-  last: 4
-  exclude_end?: true
+  Range#first: 0
+  Range#last: 4
+  Range#exclude_end?: true
 ```
 ### Regexp
 
@@ -940,11 +943,11 @@ The output shows details of the ```Regexp```.
 ```yaml
 ---
 Regexp (message='My simple regexp'):
-  to_s: "(?-mix:\\w+)"
-  casefold?: false
-  named_captures: {}
-  encoding: !ruby/encoding US-ASCII
-  fixed_encoding?: false
+  Regexp#to_s: "(?-mix:\\w+)"
+  Regexp#casefold?: false
+  Regexp#named_captures: {}
+  Regexp#encoding: !ruby/encoding US-ASCII
+  Regexp#fixed_encoding?: false
 ```
 
 #### Named Captures
@@ -965,15 +968,15 @@ The output shows details of the ```Regexp```.
 ```yaml
 ---
 Regexp (message='My regexp with named captures'):
-  to_s: "(?-mix:(?<a>.)(?<b>.))"
-  casefold?: false
-  named_captures:
+  Regexp#to_s: "(?-mix:(?<a>.)(?<b>.))"
+  Regexp#casefold?: false
+  Regexp#named_captures:
     a:
     - 1
     b:
     - 2
-  encoding: !ruby/encoding US-ASCII
-  fixed_encoding?: false
+  Regexp#encoding: !ruby/encoding US-ASCII
+  Regexp#fixed_encoding?: false
 ```
 ### Set
 
@@ -997,7 +1000,7 @@ The output shows details of the set.
 ```yaml
 ---
 Set (message='My simple set'):
-  size: 3
+  Set#size: 3
   Element 0: Fixnum 5
   Element 1: Fixnum 10
   Element 2: Fixnum 15
@@ -1023,20 +1026,20 @@ The output shows details of the set.
 ```yaml
 ---
 Set (message='My mixed set'):
-  size: 3
+  Set#size: 3
   Element 0: Fixnum 0
   Element 1:
     String:
-      to_s: one
-      size: 3
-      encoding: !ruby/encoding UTF-8
-      ascii_only?: true
-      bytesize: 3
+      String#to_s: one
+      String#size: 3
+      String#encoding: !ruby/encoding UTF-8
+      String#ascii_only?: true
+      String#bytesize: 3
   Element 2:
     Symbol:
-      to_s: two
-      size: 3
-      encoding: !ruby/encoding US-ASCII
+      Symbol#to_s: two
+      Symbol#size: 3
+      Symbol#encoding: !ruby/encoding US-ASCII
 ```
 
 #### Nested Sets
@@ -1063,16 +1066,16 @@ The output shows details of the sets.
 ```yaml
 ---
 Set (message='My nested sets'):
-  size: 3
+  Set#size: 3
   Element 0: Fixnum 0
   Element 1:
     Set:
-      size: 2
+      Set#size: 2
       Element 0: Fixnum 1
       Element 1: Fixnum 2
   Element 2:
     Set:
-      size: 2
+      Set#size: 2
       Element 0: Fixnum 3
       Element 1: Fixnum 4
 ```
@@ -1102,10 +1105,10 @@ The circular reference is not followed.
 ```yaml
 ---
 Set (message='My circular sets'):
-  size: 1
+  Set#size: 1
   Element 0:
     Set:
-      size: 1
+      Set#size: 1
       Element 0: 'Set #<Set: {#<Set: {#<Set: {...}>}>}>'
 ```
 ### String
@@ -1128,11 +1131,11 @@ The output shows details of the string.
 ```yaml
 ---
 String (message='My simple string'):
-  to_s: Lorem ipsum
-  size: 11
-  encoding: !ruby/encoding UTF-8
-  ascii_only?: true
-  bytesize: 11
+  String#to_s: Lorem ipsum
+  String#size: 11
+  String#encoding: !ruby/encoding UTF-8
+  String#ascii_only?: true
+  String#bytesize: 11
 ```
 
 #### Multiline String
@@ -1156,13 +1159,13 @@ The output shows details of the string.
 ```yaml
 ---
 String (message='My multiline string'):
-  to_s: |
+  String#to_s: |
     Lorem Ipsum dolor sit amet,consectetur adipisicing elit,
     sed doeiusmod tempor incididunt ut laboreet dolore magna aliqua.
-  size: 122
-  encoding: !ruby/encoding UTF-8
-  ascii_only?: true
-  bytesize: 122
+  String#size: 122
+  String#encoding: !ruby/encoding UTF-8
+  String#ascii_only?: true
+  String#bytesize: 122
 ```
 ### Struct
 
@@ -1185,27 +1188,27 @@ The output shows details of the struct.
 ```yaml
 ---
 MyStruct (message='My simple struct'):
-  size: 3
+  MyStruct#size: 3
   Member 0:
     Name:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 0
   Member 1:
     Name:
       Symbol:
-        to_s: b
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: b
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 1
   Member 2:
     Name:
       Symbol:
-        to_s: c
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: c
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 2
 ```
 
@@ -1228,38 +1231,38 @@ The output shows details of the struct.
 ```yaml
 ---
 MyStruct (message='My mixed struct'):
-  size: 3
+  MyStruct#size: 3
   Member 0:
     Name:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 0
   Member 1:
     Name:
       Symbol:
-        to_s: b
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: b
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       String:
-        to_s: one
-        size: 3
-        encoding: !ruby/encoding UTF-8
-        ascii_only?: true
-        bytesize: 3
+        String#to_s: one
+        String#size: 3
+        String#encoding: !ruby/encoding UTF-8
+        String#ascii_only?: true
+        String#bytesize: 3
   Member 2:
     Name:
       Symbol:
-        to_s: c
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: c
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       Symbol:
-        to_s: two
-        size: 3
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: two
+        Symbol#size: 3
+        Symbol#encoding: !ruby/encoding US-ASCII
 ```
 
 #### Nested Structs
@@ -1284,52 +1287,52 @@ The output shows details of the structs.
 ```yaml
 ---
 MyStruct_0 (message='My nested struct'):
-  size: 2
+  MyStruct_0#size: 2
   Member 0:
     Name:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       MyStruct_1:
-        size: 2
+        MyStruct_1#size: 2
         Member 0:
           Name:
             Symbol:
-              to_s: c
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: c
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 2
         Member 1:
           Name:
             Symbol:
-              to_s: d
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: d
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 3
   Member 1:
     Name:
       Symbol:
-        to_s: b
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: b
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       MyStruct_1:
-        size: 2
+        MyStruct_1#size: 2
         Member 0:
           Name:
             Symbol:
-              to_s: c
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: c
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 4
         Member 1:
           Name:
             Symbol:
-              to_s: d
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: d
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 5
 ```
 
@@ -1357,51 +1360,51 @@ The circular reference is not followed.
 ```yaml
 ---
 MyStruct (message='My circular struct'):
-  size: 3
+  MyStruct#size: 3
   Member 0:
     Name:
       Symbol:
-        to_s: a
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: a
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value:
       MyStruct:
-        size: 3
+        MyStruct#size: 3
         Member 0:
           Name:
             Symbol:
-              to_s: a
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: a
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: 'MyStruct #<struct MyStruct a=#<struct MyStruct a=#<struct MyStruct:...>,
             b=4, c=5>, b=1, c=2>'
         Member 1:
           Name:
             Symbol:
-              to_s: b
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: b
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 4
         Member 2:
           Name:
             Symbol:
-              to_s: c
-              size: 1
-              encoding: !ruby/encoding US-ASCII
+              Symbol#to_s: c
+              Symbol#size: 1
+              Symbol#encoding: !ruby/encoding US-ASCII
           Value: Fixnum 5
   Member 1:
     Name:
       Symbol:
-        to_s: b
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: b
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 1
   Member 2:
     Name:
       Symbol:
-        to_s: c
-        size: 1
-        encoding: !ruby/encoding US-ASCII
+        Symbol#to_s: c
+        Symbol#size: 1
+        Symbol#encoding: !ruby/encoding US-ASCII
     Value: Fixnum 2
 ```
 ### Symbol
@@ -1423,9 +1426,9 @@ The output shows details of the symbol.
 ```yaml
 ---
 Symbol (message='My symbol'):
-  to_s: lorem_ipsum
-  size: 11
-  encoding: !ruby/encoding US-ASCII
+  Symbol#to_s: lorem_ipsum
+  Symbol#size: 11
+  Symbol#encoding: !ruby/encoding US-ASCII
 ```
 ### Object
 
@@ -1454,6 +1457,261 @@ The output shows details of the object.
 --- MyClass (message='My class') My class inspection
 ...
 ```
+### Custom
+
+You can create custom handlers for your own classes.
+
+#### Instance Methods
+
+This example shows a custom handler that explicates via instance methods.
+
+Here's a class ```Foo``` that has some instance methods:
+ 
+```foo.rb```:
+```ruby
+require 'debug_helper'
+
+class Foo
+
+  def my_array
+    %w/foo bar baz/
+  end
+
+  def my_hash
+    {:a => 0, :b => 1}
+  end
+
+end
+```
+
+Here's its custom debug handler class ```FooHandler```.  The array returned by method ```calls_for_instance``` tells the base class ```Handler``` which methods to call for the explication, and what arguments to pass, if any.
+
+```foo_handler.rb```:
+```ruby
+require 'debug_helper'
+
+class DebugHelper
+
+  class FooHandler < Handler
+
+    def calls_for_instance
+      [
+          [:my_array],
+          [:my_hash],
+          [:respond_to?, :your_array],
+          [:respond_to?, :your_hash],
+      ]
+    end
+
+  end
+
+end
+```
+
+Here's a program that uses the custom handler.
+
+```show.rb```:
+```ruby
+require 'debug_helper'
+require_relative 'foo'
+require_relative 'foo_handler'
+
+DebugHelper.show(Foo.new, 'My class Foo')
+```
+
+The output shows details of the object.
+
+```show.yaml```:
+```yaml
+---
+Foo (message='My class Foo'):
+  Foo#my_array:
+  - foo
+  - bar
+  - baz
+  Foo#my_hash:
+    :a: 0
+    :b: 1
+  Foo#respond_to?(:your_array): false
+  Foo#respond_to?(:your_hash): false
+```
+
+#### Singleton Methods
+
+This example shows a custom handler that explicates via singleton methods.
+
+Here's a class ```Foo``` that has some singleton methods:
+ 
+```foo.rb```:
+```ruby
+require 'debug_helper'
+
+class Foo
+
+  def self.my_array
+    %w/bat bam bad/
+  end
+
+  def self.my_hash
+    {:c => 2, :d => 3}
+  end
+
+end
+```
+
+Here's its custom debug handler class ```FooHandler```.  The array returned in method ```calls_for_class``` tells the base class ```Handler``` which methods to call for the explication.
+
+```foo_handler.rb```:
+```ruby
+require 'debug_helper'
+
+class DebugHelper
+
+  class FooHandler < Handler
+
+    def calls_for_class
+      [
+          [:my_array],
+          [:my_hash],
+          [:respond_to?, :your_array],
+          [:respond_to?, :your_hash],
+      ]
+    end
+
+  end
+
+end
+```
+
+Here's a program that uses the custom handler.
+
+```show.rb```:
+```ruby
+require 'debug_helper'
+require_relative 'foo'
+require_relative 'foo_handler'
+
+DebugHelper.show(Foo.new, 'My class Foo')
+```
+
+The output shows details of the object.
+
+```show.yaml```:
+```yaml
+---
+Foo (message='My class Foo'):
+  Foo.my_array:
+  - bat
+  - bam
+  - bad
+  Foo.my_hash:
+    :c: 2
+    :d: 3
+  Foo.respond_to?(:your_array): false
+  Foo.respond_to?(:your_hash): false
+```
+
+#### Instance and Singleton Methods
+
+This example shows a custom handler that explicates via both kinds of methods.
+
+Here's a class ```Foo``` that has instance methods and singleton methods:
+ 
+```foo.rb```:
+```ruby
+require 'debug_helper'
+
+class Foo
+
+  def my_array
+    %w/foo bar baz/
+  end
+
+  def my_hash
+    {:a => 0, :b => 1}
+  end
+
+  def self.my_array
+    %w/bat bam bad/
+  end
+
+  def self.my_hash
+    {:c => 2, :d => 3}
+  end
+
+end
+```
+
+Here's its custom debug handler class ```FooHandler```.
+
+```foo_handler.rb```:
+```ruby
+require 'debug_helper'
+
+class DebugHelper
+
+  class FooHandler < Handler
+
+    def calls_for_instance
+      [
+          [:my_array],
+          [:my_hash],
+          [:respond_to?, :your_array],
+          [:respond_to?, :your_hash],
+      ]
+    end
+
+    def calls_for_class
+      [
+          [:my_array],
+          [:my_hash],
+          [:respond_to?, :your_array],
+          [:respond_to?, :your_hash],
+      ]
+    end
+
+  end
+
+end
+```
+
+Here's a program that uses the custom handler.
+
+```show.rb```:
+```ruby
+require 'debug_helper'
+require_relative 'foo'
+require_relative 'foo_handler'
+
+DebugHelper.show(Foo.new, 'My class Foo')
+```
+
+The output shows details of the object.
+
+```show.yaml```:
+```yaml
+---
+Foo (message='My class Foo'):
+  Foo#my_array:
+  - foo
+  - bar
+  - baz
+  Foo#my_hash:
+    :a: 0
+    :b: 1
+  Foo#respond_to?(:your_array): false
+  Foo#respond_to?(:your_hash): false
+  Foo.my_array:
+  - bat
+  - bam
+  - bad
+  Foo.my_hash:
+    :c: 2
+    :d: 3
+  Foo.respond_to?(:your_array): false
+  Foo.respond_to?(:your_hash): false
+```
+
 
 ## Options
 
@@ -1486,66 +1744,66 @@ The output shows output for various depths.
 ```yaml
 ---
 Array (message='Show depth 1'):
-  size: 2
+  Array#size: 2
   Element 0: Fixnum 0
   Element 1: Array [1, [2, [3, [4]]]]
 ---
 Array (message='Show depth 2'):
-  size: 2
+  Array#size: 2
   Element 0: Fixnum 0
   Element 1:
     Array:
-      size: 2
+      Array#size: 2
       Element 0: Fixnum 1
       Element 1: Array [2, [3, [4]]]
 ---
 Array (message='Show depth 3'):
-  size: 2
+  Array#size: 2
   Element 0: Fixnum 0
   Element 1:
     Array:
-      size: 2
+      Array#size: 2
       Element 0: Fixnum 1
       Element 1:
         Array:
-          size: 2
+          Array#size: 2
           Element 0: Fixnum 2
           Element 1: Array [3, [4]]
 ---
 Array (message='Show depth 4'):
-  size: 2
+  Array#size: 2
   Element 0: Fixnum 0
   Element 1:
     Array:
-      size: 2
+      Array#size: 2
       Element 0: Fixnum 1
       Element 1:
         Array:
-          size: 2
+          Array#size: 2
           Element 0: Fixnum 2
           Element 1:
             Array:
-              size: 2
+              Array#size: 2
               Element 0: Fixnum 3
               Element 1: Array [4]
 ---
 Array (message='Show depth 5'):
-  size: 2
+  Array#size: 2
   Element 0: Fixnum 0
   Element 1:
     Array:
-      size: 2
+      Array#size: 2
       Element 0: Fixnum 1
       Element 1:
         Array:
-          size: 2
+          Array#size: 2
           Element 0: Fixnum 2
           Element 1:
             Array:
-              size: 2
+              Array#size: 2
               Element 0: Fixnum 3
               Element 1:
                 Array:
-                  size: 1
+                  Array#size: 1
                   Element 0: Fixnum 4
 ```