Contents

= hexy -- utility to create hex dumps 

`hexy` is a ruby library that's easy to use to create hex dumps from 
within your ruby scripts. It contains a number of options to configure
how the hex dumb will end up looking.

It should create a pleasant looking hex dumb by default:

   b = Hexy.new "\000\001\003\005\037\012\011bcdefghijklmnopqrstuvwxyz0123456789"
   puts b.to_s

results in this dump:

	0000000: 00 01 03 05 1f 0a 09 62   63 64 65 66 67 68 69 6a  .......b cdefghij 
	0000010: 6b 6c 6d 6e 6f 70 71 72   73 74 75 76 77 78 79 7a  klmnopqr stuvwxyz 
	0000020: 30 31 32 33 34 35 36 37   38 39                    01234567 89

but it's also possible to configure:

* Line numbering
* Line width
* Format
* Case of hex decimals
* Presence of the ASCII annotation in the right column.

This mean you can do exciting dumps like:

	0000000: 0001 0305 1f0a 0962  .... ...b 
	0000008: 6364 6566 6768 696a  cdef ghij 
	0000010: 6b6c 6d6e 6f70 7172  klmn opqr 
	0000018: 7374 7576 7778 797a  stuv wxyz 
	0000020: 3031 3233 3435 3637  0123 4567 
	0000028: 3839                 89

or even:

	0000000: 00 01 03 05 1f 0a 09 62   63 64 65 66 67 68 69 6a 
	0000010: 6b 6c 6d 6e 6f 70 71 72   73 74 75 76 77 78 79 7a 
	0000020: 30 31 32 33 34 35 36 37   38 39

with hexy!
   

== Installing

Having a "Installing" section is a bit of a chicken or egg question.
Someone reading this README has, in all likelyhood already installed the
package. 

 You can install the +hexy+ package by executing:

	gem install hexy -r

alternatively, you can download +.tar.gz+ or +.zip+ archives from 
Rubyforge[http://rubyforge.org/frs/?group_id=2203].


== Mail

In case you discover bugs, spelling errors, offer suggestions for
improvements or would like to help out with the project, you can contact
me directly ([e-mail]).	















=

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
hexy-0.1.2	README
hexy-0.1.0	README