This is a ruby library (and a gem) which facilitates printing a hexadecimal dump of a given binary/string.
The example directory has sample usage of the library.
This is tested on Ruby versions 1.9.3 and above
The usage of this library is very straightforward. Usage examples are shown below.
Install the gem (preferred way)
gem install hex_dump
of clone the code from github
git clone https://github.com/shivampatel/hex_dump.git
require 'hex_dump'
contents = File.read("your_file.jpg") # dumping file
contents = socket.recv(1024) # or data from a network socket
# Display hex with default options
HexDump.print contents
# display hex in color Yellow.
HexDump.print contents, options={hex_color: HexDump::CYAN}
# display hex with line width 24 and foreground color green
HexDump.print contents, options={line_size: 24, hex_color: HexDump::GREEN}
HexDump takes options in the form of options hash. These are the options that can be passed to HexDump:
Default is white. These are the values that hex_color can take:
- HexDump::CYAN
- HexDump::BLACK
- HexDump::RED
- HexDump::GREEN
- HexDump::YELLOW
- HexDump::BLUE
- HexDump::MAGENTA
- HexDump::CYAN
- HexDump::WHITE
line_size can be 16, 24, 32 or 64. Default is 16
Delimiter is the character that delimits the line numbers and the hex characters. Default is ":". Users can pass any character or string to denote a different delimiter.
One use case of having different delimiters is to differentiate between different streams of data. Eg. differentiate between SSL data and plain text data in a hex stream of network but having delimiters as 'S' and ':' respectively.