hexdump 0.3.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc17566453285686c384ffb48945dfa526b3d4ea24a3edec8b193540ec40fead
-  data.tar.gz: cfd9d433a9d11d85b43cd98a46e4b8c1aa67dcc572bd0ebfd7771469bbc315ed
+  metadata.gz: 6c7d2cd541f81ae5ed4191d544eac913e7e9b2f55fad23320fedb00ce6b02eb2
+  data.tar.gz: 6c12dd82076f8b2bf1272ad47f9e509c6f0553642c9ad2079eeab38bca3dad36
 SHA512:
-  metadata.gz: bcc397a847ff0d4b9cfef884d6c8c97ed344cbded5242cfeccd2e6e61dc755a4dfb3ac20ddfc65d66f1428dce3ba36ab46858c9c2fdb2e43905b73c4f39e0c10
-  data.tar.gz: 3917cbf496621c7ddd8e9aec840be04b1836145f082fa0eefe016438cba570cda39013becd7a07fefdb8e4a0c1e9a13b17690f238da468ed528792c043e1c1f4
+  metadata.gz: cf2a9fc5999b94a8ad91b5bcef2a001a66e1e2f9e177b37c7e256df6775b708d84e061b0024428f3c6a0834d42f148d714f0e200a923b64f979761d500f60088
+  data.tar.gz: 7044bdfd16ff11ac1cb38b9d1f9d28faf61d147d1f5f2932e37e018479de77c194e587e39342a45103c6c4acc2128f09463d1b56f44637f99e850103c07a7c87

data/ChangeLog.md

@@ -1,3 +1,69 @@
+### 1.0.0 / 2021-08-31
+
+* Added the ability to hexdump typed data. Available `type:`s are :
+  * `:char` - signed 8bit ASCII character
+  * `:uchar` - unsigned 8bit ASCII character
+  * `:int8` - signed 8bit integer
+  * `:uin8` / `:byte` - unsigned 8bit integer (default)
+  * `:int16` / `:short` - signed 16bit integer
+  * `:int16_le` / `:short_le` - signed 16bit integer (little endian)
+  * `:int16_be` / `:short_be` - signed 16bit integer (big endian)
+  * `:int16_ne` / `:short_ne` - signed 16bit integer (network endian)
+  * `:uint16` / `:ushort` - unsigned 16bit integer
+  * `:uint16_le` / `:ushort_le` - unsigned 16bit integer (little endian)
+  * `:uint16_be` / `:ushort_be` - unsigned 16bit integer (big endian)
+  * `:uint16_ne` / `:ushort_ne` - unsigned 16bit integer (network endian)
+  * `:int32` / `:int` / `:long` - signed 32bit integer
+  * `:int32_le` / `:int_le` / `:long_le` - signed 32bit integer (little endian)
+  * `:int32_be` / `:int_be` / `:long_be` - signed 32bit integer (big endian)
+  * `:int32_ne` / `:int_ne` / `:long_ne` - signed 32bit integer (network endian)
+  * `:uint32` / `:uint` / `:ulong` - unsigned 32bit integer
+  * `:uint32_le` / `:uint_le` / `:ulong_le` - unsigned 32bit integer (little endian)
+  * `:uint32_be` / `:uint_be` / `:ulong_be` - unsigned 32bit integer (big endian)
+  * `:uint32_ne` / `:uint_ne` / `:ulong_ne` - unsigned 32bit integer (network endian)
+  * `:int64` / `:long_long` - signed 64bit integer
+  * `:int64_le` / `:long_long_le` - signed 64bit integer (little endian)
+  * `:int64_be` / `:long_long_be` - signed 64bit integer (big endian)
+  * `:int64_ne` / `:long_long_ne` - signed 64bit integer (network endian)
+  * `:uint64` / `:ulong_long` - unsigned 64bit integer
+  * `:uint64_le` / `:ulong_long_le` - unsigned 64bit integer (little endian)
+  * `:uint64_be` / `:ulong_long_be` - unsigned 64bit integer (big endian)
+  * `:uint64_ne` / `ulong_long_ne` - unsigned 64bit integer (network endian)
+  * `:float` - single precision 32bit floating-point number
+  * `:float_le` - single precision 32bit floating-point number (little endian)
+  * `:float_be` - single precision 32bit floating-point number (big endian)
+  * `:float_ne` - single precision 32bit floating-point number (network endian)
+  * `:double` - double precision 64bit floating-point number
+  * `:double_le` - double precision 64bit floating-point number (little endian)
+  * `:double_be` - double precision 64bit floating-point number (big endian)
+  * `:double_ne` - double precision 64bit floating-point number (network endian)
+* Added support for optionally skipping N bytes or reading at most N bytes of
+  data (ex: `offset: 10` and `length: 100`).
+* Added support for optional zero-padding of the data so it aligns with the type
+  size (ex: `zero_pad: true`).
+* Added support for displaying the index in a separate numeric base than the
+  numeric columns (ex: `index_base: 10, base: 2`). Defaults to base 16.
+* Added support for omitting repeating rows with a `*` (ex: `repeating: true` or
+  `repeating: false` to disable).
+* Added support for grouping columns together like GNU `hexdump -C` (ex:
+  `group_columns: 4`).
+* Added support for grouping characters together (ex: `group_chars: 4`).
+* Added support for grouping characters together to align with the type's size
+  (ex: `group_chars: :type`).
+* Added support for displaying UTF-8 characters or other character encodings.
+* Added support for disabling the characters column entirely
+  (ex: `chars_column: false`).
+* Added support for ANSI styling and highlighting (ex: `style: {...}` and
+  `highlights: {...}`).
+* Added {Hexdump::ModuleMethods} to provide a top-level
+  {Hexdump::ModuleMethods#hexdump hexdump} method.
+  * Include {Hexdump::ModuleMethods} into {Kernel} by default.
+* Added preliminary truffleruby support.
+  * Only issue was https://github.com/oracle/truffleruby/issues/2426
+* `hexdump` methods now accept a block for configuring the hexdump instance.
+* Renamed `Hexdump::Dumper` to {Hexdump::Hexdump}.
+* Renamed the `:width` option to `:columns`.
+
 ### 0.3.0 / 2021-04-10
 
 * Require Ruby >= 2.0.0.
@@ -22,7 +88,7 @@
 ### 0.2.2 / 2012-05-27
 
 * Added {Hexdump::VERSION}.
-* Rescue `RangeError`s in {Hexdump::Dumper#format_printable}.
+* Rescue `RangeError`s in `Hexdump::Dumper#format_printable`.
 * Fixed a typo in `benchmarks/hexdump.rb` (thanks ColMcp).
 * Fixed a typo in Source URL, in the README (thanks Lawrence Woodman).
 * Documented the `:endian` option for {Hexdump.dump}.
@@ -31,7 +97,7 @@
 
 ### 0.2.1 / 2011-06-11
 
-* Fixed a major bug in {Hexdump::Dumper#dump}, where the line buffers
+* Fixed a major bug in `Hexdump::Dumper#dump`, where the line buffers
   were not being cleared.
 
 ### 0.2.0 / 2011-06-11

data/Gemfile

@@ -8,4 +8,5 @@ group :development do
   gem 'rspec',          '~> 3.0'
   gem 'kramdown'
   gem 'yard',           '~> 0.9'
+  gem 'yard-spellcheck', require: false
 end

data/README.md

@@ -5,7 +5,6 @@
 * [Source](https://github.com/postmodern/hexdump.rb)
 * [Issues](https://github.com/postmodern/hexdump.rb/issues)
 * [Documentation](http://rubydoc.info/gems/hexdump/frames)
-* [Email](mailto:postmodern.mod3 at gmail.com)
 
 ## Description
 
@@ -13,152 +12,504 @@ Simple and Fast hexdumping for Ruby.
 
 ## Features
 
+* Supports printing ASCII, hexadecimal, decimal, octal and binary bytes.
+* Supports hexdumping bytes, characters, signed/unsigned integers,
+  floating-point numbers, and in little/big/network endian byte orders:
+  * `char` - signed 8bit ASCII character
+  * `uchar` - unsigned 8bit ASCII character
+  * `int8` - signed 8bit integer
+  * `uin8` / `byte` - unsigned 8bit integer (default)
+  * `int16` / `short` - signed 16bit integer
+  * `int16_le` / `short_le` - signed 16bit integer (little endian)
+  * `int16_be` / `short_be` - signed 16bit integer (big endian)
+  * `int16_ne` / `short_ne` - signed 16bit integer (network endian)
+  * `uint16` / `ushort` - unsigned 16bit integer
+  * `uint16_le` / `ushort_le` - unsigned 16bit integer (little endian)
+  * `uint16_be` / `ushort_be` - unsigned 16bit integer (big endian)
+  * `uint16_ne` / `ushort_ne` - unsigned 16bit integer (network endian)
+  * `int32` / `int` / `long` - signed 32bit integer
+  * `int32_le` / `int_le` / `long_le` - signed 32bit integer (little endian)
+  * `int32_be` / `int_be` / `long_be` - signed 32bit integer (big endian)
+  * `int32_ne` / `int_ne` / `long_ne` - signed 32bit integer (network endian)
+  * `uint32` / `uint` / `ulong` - unsigned 32bit integer
+  * `uint32_le` / `uint_le` / `ulong_le` - unsigned 32bit integer
+    (little endian)
+  * `uint32_be` / `uint_be` / `ulong_be` - unsigned 32bit integer (big endian)
+  * `uint32_ne` / `uint_ne` / `ulong_ne` - unsigned 32bit integer
+    (network endian)
+  * `int64` / `long_long` - signed 64bit integer
+  * `int64_le` / `long_long_le` - signed 64bit integer (little endian)
+  * `int64_be` / `long_long_be` - signed 64bit integer (big endian)
+  * `int64_ne` / `long_long_ne` - signed 64bit integer (network endian)
+  * `uint64` / `ulong_long` - unsigned 64bit integer
+  * `uint64_le` / `ulong_long_le` - unsigned 64bit integer (little endian)
+  * `uint64_be` / `ulong_long_be` - unsigned 64bit integer (big endian)
+  * `uint64_ne` / `ulong_long_ne` - unsigned 64bit integer (network endian)
+  * `float` - single precision 32bit floating-point number
+  * `float_le` - single precision 32bit floating-point number (little endian)
+  * `float_be` - single precision 32bit floating-point number (big endian)
+  * `float_ne` - single precision 32bit floating-point number (network endian)
+  * `double` - double precision 64bit floating-point number
+  * `double_le` - double precision 64bit floating-point number (little endian)
+  * `double_be` - double precision 64bit floating-point number (big endian)
+  * `double_ne` - double precision 64bit floating-point number (network endian)
+* Supports optionally skipping N bytes or reading at most N bytes of data.
+* Supports optional zero-padding of the data.
+* Supports omitting repeating rows with a `*`.
+* Supports grouping columns together like GNU `hexdump -C`.
+* Supports grouping characters together to align with the type's size.
+* Supports displaying characters inline like GNU `hexdump -c`.
+* Supports displaying UTF-8 characters or other character encodings.
+* Supports ANSI styling and highlighting.
 * Can hexdump any Object supporting the `each_byte` method.
 * Can send the hexdump output to any Object supporting the `<<` method.
-* Can yield each line of hexdump, instead of printing the output.
-* Supports printing ASCII, hexadecimal, decimal, octal and binary bytes.
-* Supports hexdumping bytes (8bit), words (16bit), double-words (32bit), and
-  quad-words (64bit).
-* Supports Little Endian and Big Endian modes.
 * Makes {String}, {StringIO}, {IO}, {File} objects hexdumpable.
 * Fast-ish.
 
+## Install
+
+```shell
+$ gem install hexdump
+```
+
+### gemspec
+
+```ruby
+gem.add_dependency 'hexdump', '~> 1.0'
+```
+
+### Gemfile
+
+```ruby
+gem 'hexdump', '~> 1.0'
+```
+
 ## Examples
 
-    require 'hexdump'
-
-    data = "hello\x00"
-
-    Hexdump.dump(data)
-    # 00000000  68 65 6c 6c 6f 00                                |hello.|
-    # 00000006
-    
-    data.hexdump
-    # 00000000  68 65 6c 6c 6f 00                                |hello.|
-    # 00000006
-
-    File.open('dump.txt','w') do |file|
-      data.hexdump(:output => file)
-    end
-
-    # iterate over the hexdump lines
-    data.hexdump do |index,hex,printable|
-      index     # => 0
-      hex       # => ["68", "65", "6c", "6c", "6f", "00"]
-      printable # => ["h", "e", "l", "l", "o", "."]
-    end
-    # => 6
-
-    # configure the width of the hexdump
-    Hexdump.dump('A' * 30, width: 10)
-    # 00000000  41 41 41 41 41 41 41 41 41 41  |AAAAAAAAAA|
-    # 0000000a  41 41 41 41 41 41 41 41 41 41  |AAAAAAAAAA|
-    # 00000014  41 41 41 41 41 41 41 41 41 41  |AAAAAAAAAA|
-    # 0000001e
-
-    Hexdump.dump(data, ascii: true)
-    # 00000000  h e l l o 00                                     |hello.|
-    # 00000006
-
-    Hexdump.dump(data, base: 16)
-    # 00000000  68 65 6c 6c 6f 00                                |hello.|
-    # 00000006
-
-    Hexdump.dump(data, base: :decimal)
-    # 00000000  104 101 108 108 111   0                                          |hello.|
-    # 00000006
-
-    Hexdump.dump(data, base: :octal)
-    # 00000000  0150 0145 0154 0154 0157 0000                                                    |hello.|
-    # 00000006
-
-    Hexdump.dump(data, base: :binary)
-    # 00000000  01101000 01100101 01101100 01101100 01101111 00000000                                                                                            |hello.|
-    # 00000006
-
-    ("ABC" * 10).hexdump(word_size: 2)
-    # 00000000  4241 4143 4342 4241 4143 4342 4241 4143  |䉁䅃䍂䉁䅃䍂䉁䅃|
-    # 00000010  4342 4241 4143 4342 4241 4143 4342       |䍂䉁䅃䍂䉁䅃䍂|
-    # 0000001e
+```ruby
+require 'hexdump'
 
-## Install
+Hexdump.hexdump("hello\0")
+# 00000000  68 65 6c 6c 6f 00                                |hello.|
+# 00000006
+```
+
+### Core Extensions
+
+```ruby
+"hello\0".hexdump
+# 00000000  68 65 6c 6c 6f 00                                |hello.|
+# 00000006
+```
+
+```ruby
+File.hexdump("/bin/ls")
+# ...
+```
+
+### Output (file)
+
+```ruby
+File.open('dump.txt','w') do |file|
+  data.hexdump(output: file)
+end
+```
+
+### UTF-8
+
+```ruby
+Hexdump.hexdump("\u8000" * 8, encoding: :utf8)
+# 00000000  e8 80 80 e8 80 80 e8 80 80 e8 80 80 e8 80 80 e8  |耀耀耀耀耀.|
+# 00000010  80 80 e8 80 80 e8 80 80                          |..耀耀|
+# 00000018
+```
+
+### Columns
 
-    $ gem install hexdump
+```ruby
+Hexdump.hexdump('A' * 30, columns: 10)
+# 00000000  41 41 41 41 41 41 41 41 41 41  |AAAAAAAAAA|
+# *
+# 0000001e
+```
+
+### Repeating Columns
+
+```ruby
+Hexdump.hexdump('A' * 30, columns: 10, repeating: true)
+# 00000000  41 41 41 41 41 41 41 41 41 41  |AAAAAAAAAA|
+# 0000000a  41 41 41 41 41 41 41 41 41 41  |AAAAAAAAAA|
+# 00000014  41 41 41 41 41 41 41 41 41 41  |AAAAAAAAAA|
+# 0000001e
+```
+
+### Grouping Columns
+
+```ruby
+Hexdump.hexdump("ABCD" * 8, columns: 16, group_columns: 4, repeating: true)
+# 00000000  41 42 43 44  41 42 43 44  41 42 43 44  41 42 43 44  |ABCDABCDABCDABCD|
+# 00000010  41 42 43 44  41 42 43 44  41 42 43 44  41 42 43 44  |ABCDABCDABCDABCD|
+# 00000020
+```
+
+### Grouping Chars
+
+```ruby
+Hexdump.hexdump("ABCD" * 8, group_chars: 4)
+# 00000000  41 42 43 44 41 42 43 44 41 42 43 44 41 42 43 44  |ABCD|ABCD|ABCD|ABCD|
+# *
+# 00000020
+```
+
+### Grouping UTF-8 Chars
+
+```ruby
+Hexdump.hexdump("\u8000" * 8, group_chars: 4, encoding: :utf8)
+# 00000000  e8 80 80 e8 80 80 e8 80 80 e8 80 80 e8 80 80 e8  |耀.|...|.耀|耀.|
+# 00000010  80 80 e8 80 80 e8 80 80                          |...|.耀|
+# 00000018
+```
+
+### Disable Chars
+
+```ruby
+Hexdump.hexdump('A' * 30, chars_column: false)
+00000000  41 41 41 41 41 41 41 41 41 41 41 41 41 41 41 41
+00000010  41 41 41 41 41 41 41 41 41 41 41 41 41 41      
+0000001e
+```
+
+### Hexadecimal
+
+```ruby
+Hexdump.hexdump("hello\0", base: 16)
+# 00000000  68 65 6c 6c 6f 00                                |hello.|
+# 00000006
+```
+
+### Decimal
+
+```ruby
+Hexdump.hexdump("hello\0", base: 10)
+# 00000000  104 101 108 108 111   0                                          |hello.|
+# 00000006
+```
+
+### Octal
+
+```ruby
+Hexdump.hexdump("hello\0", base: 8)
+# 00000000  0150 0145 0154 0154 0157 0000                                                    |hello.|
+# 00000006
+```
+
+### Binary
+
+```ruby
+Hexdump.hexdump("hello\0", base: 2)
+# 00000000  01101000 01100101 01101100 01101100 01101111 00000000                                                                                            |hello.|
+# 00000006
+```
+
+### UInt Type
+
+```ruby
+Hexdump.hexdump("ABCD" * 7, type: :uint32)
+# 00000000  44434241 44434241 44434241 44434241  |ABCDABCDABCDABCD|
+# 00000010  44434241 44434241 44434241           |ABCDABCDABCD|
+# 0000001c
+```
+
+### Little-endian
+
+```ruby
+Hexdump.hexdump("ABCD" * 7, type: :uint32_le)
+# 00000000  44434241 44434241 44434241 44434241  |ABCDABCDABCDABCD|
+# 00000010  44434241 44434241 44434241           |ABCDABCDABCD|
+# 0000001c
+```
+
+### Big-endian
+
+```ruby
+Hexdump.hexdump("ABCD" * 7, type: :uint32_be)
+# 00000000  41424344 41424344 41424344 41424344  |ABCDABCDABCDABCD|
+# 00000010  41424344 41424344 41424344           |ABCDABCDABCD|
+# 0000001c
+```
+
+### Int Type
+
+```ruby
+Hexdump.hexdump([65535, -1].pack("LL"), type: :int32_be, base: 10)
+# 00000000       65535         -1                          |........|
+# 00000008
+```
+
+### Char Type
+
+```ruby
+Hexdump.hexdump("hello\0", type: :char)
+# 00000000    h   e   l   l   o  \0                                          |hello.|
+# 00000006
+```
+
+### Float Type
+
+```ruby
+Hexdump.hexdump([0.0, 1.0, -1.0, Float::NAN].pack('EEEE'), type: :float64_le)
+# 00000000          0.000000e+00         1.000000e+00  |...............?|
+# 00000010         -1.000000e+00                  NaN  |................|
+# 00000020
+```
+
+### Skipping Data
+
+```ruby
+Hexdump.hexdump("GARBAGEabc123", offset: 7)
+# 00000007  61 62 63 31 32 33                                |abc123|
+# 0000000d
+```
+
+### Zero-padding
+
+```ruby
+Hexdump.hexdump(("ABCD" * 4) + "AB", type: :uint32_be, zero_pad: true)
+# 00000000  41424344 41424344 41424344 41424344  |ABCDABCDABCDABCD|
+# 00000010  41420000                             |AB..|
+# 00000014
+```
+
+### ANSI Styling
+
+```ruby
+Hexdump.hexdump("ABCD", style: {index: :white, numeric: :green, chars: :cyan})
+```
+
+### ANSI Highlighting
+
+```ruby
+Hexdump.hexdump((0..255).map(&:chr).join, highlights: {
+  index: {/00$/ => [:white, :bold]},
+  numeric: {
+    /^[8-f][0-9a-f]$/ => :faint,
+    /f/  => :cyan,
+    '00' => [:black, :on_red]
+  },
+  chars: {/[^\.]+/ => :green}
+})
+```
+
+### Block Configuration
+
+```ruby
+Hexdump.hexdump("hello\0") do |hex|
+  hex.type = :uint16_le
+  hex.group_chars = :type
+  # ...
+end
+# 00000000  6568 6c6c 006f                           |he|ll|o.|
+# 00000006
+```
 
 ## Benchmarks
 
-Benchmarks show {Hexdump.dump} processing 25M of data.
-
-### Ruby 2.7.3
-
-```
-                                        user     system      total        real
-Hexdump.dump (output)              10.283433   0.000748  10.284181 ( 10.328899)
-Hexdump.dump width=256 (output)     8.803228   0.005973   8.809201 (  8.838375)
-Hexdump.dump ascii=true (output)   10.740975   0.001903  10.742878 ( 10.779777)
-Hexdump.dump word_size=2 (output)  15.163195   0.000989  15.164184 ( 15.220481)
-Hexdump.dump word_size=4 (output)  14.279406   0.003840  14.283246 ( 14.345357)
-Hexdump.dump word_size=8 (output)   7.715803   0.002879   7.718682 (  7.746389)
-Hexdump.dump (block)                5.543268   0.000980   5.544248 (  5.561494)
-Hexdump.dump width=256 (block)      5.438946   0.000000   5.438946 (  5.455742)
-Hexdump.dump ascii=true (block)     6.082787   0.000924   6.083711 (  6.106234)
-Hexdump.dump word_size=2 (block)   11.439610   0.000983  11.440593 ( 11.483788)
-Hexdump.dump word_size=4 (block)   11.111633   0.000954  11.112587 ( 11.158416)
-Hexdump.dump word_size=8 (block)    5.397569   0.002896   5.400465 (  5.426971)
-```
-
-### Ruby 3.0.1
-
-```
-                                        user     system      total        real
-Hexdump.dump (output)              12.064022   0.001165  12.065187 ( 12.118272)
-Hexdump.dump width=256 (output)    10.228743   0.009920  10.238663 ( 10.279783)
-Hexdump.dump ascii=true (output)   12.532913   0.000000  12.532913 ( 12.582665)
-Hexdump.dump word_size=2 (output)  17.685782   0.000000  17.685782 ( 17.770686)
-Hexdump.dump word_size=4 (output)  15.835564   0.000000  15.835564 ( 15.917552)
-Hexdump.dump word_size=8 (output)   8.436831   0.000000   8.436831 (  8.473445)
-Hexdump.dump (block)                6.482589   0.000000   6.482589 (  6.504816)
-Hexdump.dump width=256 (block)      6.360828   0.000000   6.360828 (  6.383705)
-Hexdump.dump ascii=true (block)     6.911868   0.000000   6.911868 (  6.936795)
-Hexdump.dump word_size=2 (block)   13.120488   0.000000  13.120488 ( 13.179957)
-Hexdump.dump word_size=4 (block)   12.349516   0.000000  12.349516 ( 12.412972)
-Hexdump.dump word_size=8 (block)    5.814830   0.000000   5.814830 (  5.837822)
-```
-
-### JRuby 9.2.16.0
-
-```
-                                        user     system      total        real
-Hexdump.dump (output)              13.090000   0.240000  13.330000 ( 11.226466)
-Hexdump.dump width=256 (output)     9.350000   0.030000   9.380000 (  9.165070)
-Hexdump.dump ascii=true (output)   10.910000   0.050000  10.960000 ( 10.665791)
-Hexdump.dump word_size=2 (output)  13.760000   0.150000  13.910000 ( 12.268307)
-Hexdump.dump word_size=4 (output)  11.940000   0.090000  12.030000 ( 11.107564)
-Hexdump.dump word_size=8 (output)   8.170000   0.040000   8.210000 (  7.419708)
-Hexdump.dump (block)                7.840000   0.020000   7.860000 (  7.777749)
-Hexdump.dump width=256 (block)      7.540000   0.000000   7.540000 (  7.466315)
-Hexdump.dump ascii=true (block)     7.680000   0.010000   7.690000 (  7.622393)
-Hexdump.dump word_size=2 (block)    9.830000   0.020000   9.850000 (  9.693596)
-Hexdump.dump word_size=4 (block)    9.010000   0.020000   9.030000 (  8.998687)
-Hexdump.dump word_size=8 (block)    5.740000   0.030000   5.770000 (  5.709127)
-```
-
-### TruffleRuby 21.0.0
-
-```
-                                        user     system      total        real
-Hexdump.dump (output)              25.818995   0.855689  26.674684 ( 22.376015)
-Hexdump.dump width=256 (output)    20.489077   0.125966  20.615043 ( 18.301748)
-Hexdump.dump ascii=true (output)   25.214678   0.098018  25.312696 ( 21.714985)
-Hexdump.dump word_size=2 (output)  28.380387   0.192277  28.572664 ( 23.736887)
-Hexdump.dump word_size=4 (output)  31.348977   0.134854  31.483831 ( 27.710968)
-Hexdump.dump word_size=8 (output)  18.850093   0.100256  18.950349 ( 13.921720)
-Hexdump.dump (block)                7.792878   0.050542   7.843420 (  6.003789)
-Hexdump.dump width=256 (block)      6.526531   0.015898   6.542429 (  5.777169)
-Hexdump.dump ascii=true (block)     7.425399   0.030799   7.456198 (  5.705369)
-Hexdump.dump word_size=2 (block)   12.629775   0.028653  12.658428 ( 11.115049)
-Hexdump.dump word_size=4 (block)   20.372094   0.010807  20.382901 ( 19.758073)
-Hexdump.dump word_size=8 (block)    8.828653   0.010889   8.839542 (  8.017241)
+Benchmarks show hexdumping 1Mb of random data.
+
+### Ruby 2.7.4
+
+```
+                                                 user     system      total        real
+Hexdump.hexdump(data)                        1.148697   0.025829   1.174526 (  1.183447)
+Hexdump.hexdump(data, repeating: false)      1.050473   0.000000   1.050473 (  1.057167)
+Hexdump.hexdump(data, chars_column: false)   0.878459   0.002912   0.881371 (  0.888779)
+Hexdump.hexdump(data, columns: 256)          0.793922   0.008785   0.802707 (  0.810535)
+Hexdump.hexdump(data, group_columns: 4)      1.309818   0.000000   1.309818 (  1.320721)
+Hexdump.hexdump(data, group_chars: 4)        1.949181   0.000000   1.949181 (  1.975533)
+Hexdump.hexdump(data, encoding: :utf8)       1.292495   0.000000   1.292495 (  1.302071)
+Hexdump.hexdump(data, type: :char)           1.168044   0.000000   1.168044 (  1.177700)
+Hexdump.hexdump(data, type: :uchar)          1.033165   0.000000   1.033165 (  1.041185)
+Hexdump.hexdump(data, type: :int8)           1.310548   0.000000   1.310548 (  1.319847)
+Hexdump.hexdump(data, type: :uint8)          1.035534   0.000000   1.035534 (  1.041428)
+Hexdump.hexdump(data, type: :int16)          1.351306   0.009906   1.361212 (  1.370048)
+Hexdump.hexdump(data, type: :int16_le)       1.320781   0.002981   1.323762 (  1.331747)
+Hexdump.hexdump(data, type: :int16_be)       1.401554   0.003986   1.405540 (  1.414568)
+Hexdump.hexdump(data, type: :int16_ne)       1.367864   0.000000   1.367864 (  1.376459)
+Hexdump.hexdump(data, type: :uint16)         1.425247   0.003965   1.429212 (  1.438618)
+Hexdump.hexdump(data, type: :uint16_le)      1.399240   0.002979   1.402219 (  1.411098)
+Hexdump.hexdump(data, type: :uint16_be)      1.409289   0.006960   1.416249 (  1.424767)
+Hexdump.hexdump(data, type: :uint16_ne)      1.288829   0.000001   1.288830 (  1.296091)
+Hexdump.hexdump(data, type: :int32)          1.089239   0.000000   1.089239 (  1.094715)
+Hexdump.hexdump(data, type: :int32_le)       1.429353   0.000003   1.429356 (  1.441620)
+Hexdump.hexdump(data, type: :int32_be)       1.472933   0.000000   1.472933 (  1.486328)
+Hexdump.hexdump(data, type: :int32_ne)       1.357824   0.000000   1.357824 (  1.369258)
+Hexdump.hexdump(data, type: :uint32)         1.214704   0.000000   1.214704 (  1.222920)
+Hexdump.hexdump(data, type: :uint32_le)      1.253424   0.000000   1.253424 (  1.262441)
+Hexdump.hexdump(data, type: :uint32_be)      1.325268   0.000000   1.325268 (  1.335447)
+Hexdump.hexdump(data, type: :uint32_ne)      1.314893   0.000819   1.315712 (  1.328889)
+Hexdump.hexdump(data, type: :int64)          1.083071   0.000000   1.083071 (  1.092108)
+Hexdump.hexdump(data, type: :int64_le)       1.076378   0.000000   1.076378 (  1.084785)
+Hexdump.hexdump(data, type: :int64_be)       0.998069   0.000000   0.998069 (  1.005166)
+Hexdump.hexdump(data, type: :int64_ne)       0.990422   0.000000   0.990422 (  1.005638)
+Hexdump.hexdump(data, type: :uint64)         1.010946   0.000000   1.010946 (  1.018339)
+Hexdump.hexdump(data, type: :uint64_le)      0.961576   0.000000   0.961576 (  0.967806)
+Hexdump.hexdump(data, type: :uint64_be)      0.979367   0.000000   0.979367 (  0.985515)
+Hexdump.hexdump(data, type: :uint64_ne)      1.017737   0.000000   1.017737 (  1.024689)
+Hexdump.hexdump(data, type: :float32)        1.237278   0.000000   1.237278 (  1.245206)
+Hexdump.hexdump(data, type: :float32_le)     1.233321   0.000000   1.233321 (  1.241154)
+Hexdump.hexdump(data, type: :float32_be)     1.245740   0.000000   1.245740 (  1.253952)
+Hexdump.hexdump(data, type: :float32_ne)     1.256216   0.000000   1.256216 (  1.264893)
+Hexdump.hexdump(data, type: :float64)        1.122882   0.000000   1.122882 (  1.130954)
+Hexdump.hexdump(data, type: :float64_le)     1.117593   0.000000   1.117593 (  1.125222)
+Hexdump.hexdump(data, type: :float64_be)     1.139602   0.000000   1.139602 (  1.147980)
+Hexdump.hexdump(data, type: :float64_ne)     1.142568   0.000000   1.142568 (  1.150949)
+```
+
+### Ruby 3.0.2
+
+```
+                                                 user     system      total        real
+Hexdump.hexdump(data)                        0.902383   0.046875   0.949258 (  0.953623)
+Hexdump.hexdump(data, repeating: false)      0.892407   0.000046   0.892453 (  0.896401)
+Hexdump.hexdump(data, chars_column: false)   0.705909   0.001029   0.706938 (  0.709924)
+Hexdump.hexdump(data, columns: 256)          0.627444   0.009986   0.637430 (  0.640324)
+Hexdump.hexdump(data, group_columns: 4)      1.081550   0.001041   1.082591 (  1.087987)
+Hexdump.hexdump(data, group_chars: 4)        1.444519   0.000000   1.444519 (  1.452809)
+Hexdump.hexdump(data, encoding: :utf8)       1.078177   0.000003   1.078180 (  1.082981)
+Hexdump.hexdump(data, type: :char)           0.865217   0.000000   0.865217 (  0.868752)
+Hexdump.hexdump(data, type: :uchar)          0.736559   0.000000   0.736559 (  0.739721)
+Hexdump.hexdump(data, type: :int8)           1.042024   0.000000   1.042024 (  1.046687)
+Hexdump.hexdump(data, type: :uint8)          0.917350   0.000005   0.917355 (  0.921428)
+Hexdump.hexdump(data, type: :int16)          1.351638   0.004978   1.356616 (  1.363879)
+Hexdump.hexdump(data, type: :int16_le)       1.315200   0.006944   1.322144 (  1.329052)
+Hexdump.hexdump(data, type: :int16_be)       1.421759   0.005966   1.427725 (  1.435760)
+Hexdump.hexdump(data, type: :int16_ne)       1.444364   0.001995   1.446359 (  1.454039)
+Hexdump.hexdump(data, type: :uint16)         1.491169   0.001000   1.492169 (  1.500542)
+Hexdump.hexdump(data, type: :uint16_le)      1.439111   0.000000   1.439111 (  1.447745)
+Hexdump.hexdump(data, type: :uint16_be)      1.464961   0.000836   1.465797 (  1.473807)
+Hexdump.hexdump(data, type: :uint16_ne)      1.407008   0.000808   1.407816 (  1.415236)
+Hexdump.hexdump(data, type: :int32)          1.048519   0.000004   1.048523 (  1.053326)
+Hexdump.hexdump(data, type: :int32_le)       1.080497   0.000000   1.080497 (  1.085598)
+Hexdump.hexdump(data, type: :int32_be)       1.033985   0.000000   1.033985 (  1.038472)
+Hexdump.hexdump(data, type: :int32_ne)       1.057491   0.000000   1.057491 (  1.062123)
+Hexdump.hexdump(data, type: :uint32)         1.019488   0.000000   1.019488 (  1.023838)
+Hexdump.hexdump(data, type: :uint32_le)      1.014077   0.000003   1.014080 (  1.018370)
+Hexdump.hexdump(data, type: :uint32_be)      1.038020   0.000000   1.038020 (  1.042756)
+Hexdump.hexdump(data, type: :uint32_ne)      1.047465   0.000000   1.047465 (  1.052377)
+Hexdump.hexdump(data, type: :int64)          0.842281   0.000000   0.842281 (  0.845988)
+Hexdump.hexdump(data, type: :int64_le)       0.840408   0.000000   0.840408 (  0.844103)
+Hexdump.hexdump(data, type: :int64_be)       0.845470   0.000002   0.845472 (  0.849219)
+Hexdump.hexdump(data, type: :int64_ne)       0.843975   0.000000   0.843975 (  0.847644)
+Hexdump.hexdump(data, type: :uint64)         0.836761   0.000000   0.836761 (  0.840326)
+Hexdump.hexdump(data, type: :uint64_le)      0.828863   0.000000   0.828863 (  0.832319)
+Hexdump.hexdump(data, type: :uint64_be)      0.839492   0.000001   0.839493 (  0.843017)
+Hexdump.hexdump(data, type: :uint64_ne)      0.843799   0.000000   0.843799 (  0.847764)
+Hexdump.hexdump(data, type: :float32)        1.091306   0.000000   1.091306 (  1.096429)
+Hexdump.hexdump(data, type: :float32_le)     1.077634   0.000000   1.077634 (  1.082633)
+Hexdump.hexdump(data, type: :float32_be)     1.085840   0.000986   1.086826 (  1.092056)
+Hexdump.hexdump(data, type: :float32_ne)     1.093757   0.000000   1.093757 (  1.099011)
+Hexdump.hexdump(data, type: :float64)        0.873676   0.010942   0.884618 (  0.888978)
+Hexdump.hexdump(data, type: :float64_le)     0.865006   0.003984   0.868990 (  0.873156)
+Hexdump.hexdump(data, type: :float64_be)     0.879795   0.009947   0.889742 (  0.894389)
+Hexdump.hexdump(data, type: :float64_ne)     0.876483   0.010934   0.887417 (  0.892222)
+```
+
+### JRuby 9.2.19.0
+
+```
+                                                 user     system      total        real
+Hexdump.hexdump(data)                        6.440000   0.260000   6.700000 (  1.990004)
+Hexdump.hexdump(data, repeating: false)      1.920000   0.010000   1.930000 (  0.973891)
+Hexdump.hexdump(data, chars_column: false)   1.680000   0.010000   1.690000 (  0.848573)
+Hexdump.hexdump(data, columns: 256)          0.920000   0.010000   0.930000 (  0.703203)
+Hexdump.hexdump(data, group_columns: 4)      2.070000   0.010000   2.080000 (  1.119408)
+Hexdump.hexdump(data, group_chars: 4)        2.200000   0.010000   2.210000 (  1.427454)
+Hexdump.hexdump(data, encoding: :utf8)       2.280000   0.010000   2.290000 (  1.148070)
+Hexdump.hexdump(data, type: :char)           1.970000   0.020000   1.990000 (  1.022860)
+Hexdump.hexdump(data, type: :uchar)          0.940000   0.000000   0.940000 (  0.780674)
+Hexdump.hexdump(data, type: :int8)           1.580000   0.000000   1.580000 (  1.086830)
+Hexdump.hexdump(data, type: :uint8)          0.980000   0.010000   0.990000 (  0.937851)
+Hexdump.hexdump(data, type: :int16)          2.730000   0.030000   2.760000 (  1.571684)
+Hexdump.hexdump(data, type: :int16_le)       1.620000   0.000000   1.620000 (  1.354835)
+Hexdump.hexdump(data, type: :int16_be)       1.700000   0.010000   1.710000 (  1.430056)
+Hexdump.hexdump(data, type: :int16_ne)       1.640000   0.000000   1.640000 (  1.437230)
+Hexdump.hexdump(data, type: :uint16)         2.190000   0.100000   2.290000 (  1.801601)
+Hexdump.hexdump(data, type: :uint16_le)      1.770000   0.010000   1.780000 (  1.585609)
+Hexdump.hexdump(data, type: :uint16_be)      1.720000   0.000000   1.720000 (  1.555715)
+Hexdump.hexdump(data, type: :uint16_ne)      1.760000   0.010000   1.770000 (  1.540340)
+Hexdump.hexdump(data, type: :int32)          1.430000   0.000000   1.430000 (  1.133868)
+Hexdump.hexdump(data, type: :int32_le)       1.060000   0.000000   1.060000 (  1.031721)
+Hexdump.hexdump(data, type: :int32_be)       1.130000   0.010000   1.140000 (  1.096841)
+Hexdump.hexdump(data, type: :int32_ne)       1.080000   0.000000   1.080000 (  1.074743)
+Hexdump.hexdump(data, type: :uint32)         1.560000   0.010000   1.570000 (  1.053369)
+Hexdump.hexdump(data, type: :uint32_le)      1.070000   0.000000   1.070000 (  1.001372)
+Hexdump.hexdump(data, type: :uint32_be)      1.460000   0.020000   1.480000 (  1.080869)
+Hexdump.hexdump(data, type: :uint32_ne)      1.120000   0.010000   1.130000 (  0.876941)
+Hexdump.hexdump(data, type: :int64)          1.510000   0.010000   1.520000 (  0.865030)
+Hexdump.hexdump(data, type: :int64_le)       0.860000   0.000000   0.860000 (  0.770903)
+Hexdump.hexdump(data, type: :int64_be)       0.820000   0.000000   0.820000 (  0.768356)
+Hexdump.hexdump(data, type: :int64_ne)       0.760000   0.010000   0.770000 (  0.752532)
+Hexdump.hexdump(data, type: :uint64)         2.430000   0.000000   2.430000 (  1.011133)
+Hexdump.hexdump(data, type: :uint64_le)      0.850000   0.010000   0.860000 (  0.823235)
+Hexdump.hexdump(data, type: :uint64_be)      0.870000   0.000000   0.870000 (  0.822799)
+Hexdump.hexdump(data, type: :uint64_ne)      0.900000   0.000000   0.900000 (  0.829247)
+Hexdump.hexdump(data, type: :float32)        3.700000   0.020000   3.720000 (  1.862630)
+Hexdump.hexdump(data, type: :float32_le)     1.430000   0.010000   1.440000 (  1.372024)
+Hexdump.hexdump(data, type: :float32_be)     1.360000   0.010000   1.370000 (  1.333000)
+Hexdump.hexdump(data, type: :float32_ne)     1.390000   0.000000   1.390000 (  1.354031)
+Hexdump.hexdump(data, type: :float64)        2.830000   0.030000   2.860000 (  1.705892)
+Hexdump.hexdump(data, type: :float64_le)     1.370000   0.000000   1.370000 (  1.356680)
+Hexdump.hexdump(data, type: :float64_be)     1.430000   0.010000   1.440000 (  1.392404)
+Hexdump.hexdump(data, type: :float64_ne)     1.380000   0.000000   1.380000 (  1.363983)
+```
+
+### TruffleRuby 21.2.0.1
+
+```
+                                                 user     system      total        real
+Hexdump.hexdump(data)                        7.456088   0.230339   7.686427 (  2.378998)
+Hexdump.hexdump(data, repeating: false)      5.737137   0.150997   5.888134 (  1.781732)
+Hexdump.hexdump(data, chars_column: false)   6.671704   0.064265   6.735969 (  2.054377)
+Hexdump.hexdump(data, columns: 256)          4.711081   0.023574   4.734655 (  1.352932)
+Hexdump.hexdump(data, group_columns: 4)      8.762291   0.133901   8.896192 (  2.711132)
+Hexdump.hexdump(data, group_chars: 4)       13.382068   0.127633  13.509701 (  4.128705)
+Hexdump.hexdump(data, encoding: :utf8)       8.591975   0.138969   8.730944 (  2.676283)
+Hexdump.hexdump(data, type: :char)           6.455997   0.059446   6.515443 (  1.953656)
+Hexdump.hexdump(data, type: :uchar)          6.201412   0.048587   6.249999 (  1.732655)
+Hexdump.hexdump(data, type: :int8)           8.712725   0.095197   8.807922 (  2.587043)
+Hexdump.hexdump(data, type: :uint8)          5.553536   0.074358   5.627894 (  1.786634)
+Hexdump.hexdump(data, type: :int16)         11.300609   0.114115  11.414724 (  3.440795)
+Hexdump.hexdump(data, type: :int16_le)       8.040891   0.060503   8.101394 (  2.388759)
+Hexdump.hexdump(data, type: :int16_be)       6.602434   0.087225   6.689659 (  2.082091)
+Hexdump.hexdump(data, type: :int16_ne)       5.448411   0.076425   5.524836 (  1.696039)
+Hexdump.hexdump(data, type: :uint16)        10.081909   0.157579  10.239488 (  3.106461)
+Hexdump.hexdump(data, type: :uint16_le)      6.847504   0.040543   6.888047 (  2.069546)
+Hexdump.hexdump(data, type: :uint16_be)      6.730759   0.149299   6.880058 (  2.147346)
+Hexdump.hexdump(data, type: :uint16_ne)      5.539179   0.108832   5.648011 (  1.747539)
+Hexdump.hexdump(data, type: :int32)          7.998790   0.058401   8.057191 (  2.383304)
+Hexdump.hexdump(data, type: :int32_le)       4.650657   0.081202   4.731859 (  1.412741)
+Hexdump.hexdump(data, type: :int32_be)      11.538588   0.089259  11.627847 (  3.557763)
+Hexdump.hexdump(data, type: :int32_ne)       9.605673   0.146677   9.752350 (  2.995870)
+Hexdump.hexdump(data, type: :uint32)        10.404964   0.106136  10.511100 (  3.118580)
+Hexdump.hexdump(data, type: :uint32_le)      4.851154   0.080325   4.931479 (  1.463532)
+Hexdump.hexdump(data, type: :uint32_be)     11.293044   0.100121  11.393165 (  3.539708)
+Hexdump.hexdump(data, type: :uint32_ne)      9.907893   0.122000  10.029893 (  3.165294)
+Hexdump.hexdump(data, type: :int64)          9.103719   0.102995   9.206714 (  2.775106)
+Hexdump.hexdump(data, type: :int64_le)       9.304751   0.180642   9.485393 (  2.922495)
+Hexdump.hexdump(data, type: :int64_be)       7.166353   0.089344   7.255697 (  2.215438)
+Hexdump.hexdump(data, type: :int64_ne)       6.874170   0.090186   6.964356 (  2.113975)
+Hexdump.hexdump(data, type: :uint64)        12.997911   0.165758  13.163669 (  4.081488)
+Hexdump.hexdump(data, type: :uint64_le)      8.949650   0.130855   9.080505 (  2.712645)
+Hexdump.hexdump(data, type: :uint64_be)      8.948030   0.173500   9.121530 (  2.842953)
+Hexdump.hexdump(data, type: :uint64_ne)      8.055399   0.153749   8.209148 (  2.547932)
+Hexdump.hexdump(data, type: :float32)       14.345624   0.241224  14.586848 (  4.508393)
+Hexdump.hexdump(data, type: :float32_le)    10.454524   0.103136  10.557660 (  3.112175)
+Hexdump.hexdump(data, type: :float32_be)    11.073294   0.202252  11.275546 (  3.443881)
+Hexdump.hexdump(data, type: :float32_ne)     9.990956   0.091216  10.082172 (  3.022276)
+Hexdump.hexdump(data, type: :float64)       16.629231   0.279989  16.909220 (  5.163906)
+Hexdump.hexdump(data, type: :float64_le)    13.761375   0.190385  13.951760 (  4.129403)
+Hexdump.hexdump(data, type: :float64_be)    16.121047   0.277863  16.398910 (  5.019326)
+Hexdump.hexdump(data, type: :float64_ne)     8.873162   0.068414   8.941576 (  4.748072)
 ```
 
 ## Copyright