altamic / binary_finery

BinaryFinery mixes in a fluent interface to any IO entity for reading or writing binary data.

Binary Finery

Mixes in a fluent interface to any IO entity for reading and writing binary data. It handles (de)serialization of:

• Integer numbers
• Null terminated strings
• Fixed size strings

Requirements

Binary Finery assumes that the stream where is mixed in, provides the following methods:

- read or read_nonblock
- write or write_nonblock

It will run under Ruby version 1.8.7 or newer.

Examples

File.open(my_file.bin) do |f|
	f.extend(BinaryFinery)
	version = f.read_uint16_big
	length  = f.read_uint32_little
end

Install

$ gem install binary_finery

Contributing

If you'd like to hack on, please follow these instructions. To get all of the dependencies, install the gem first.

1. Fork the project and clone down your fork
2. Create a branch with a descriptive name to contain your change
3. Hack away
4. Add tests and make sure everything still passes by running rake
5. Do not change the version number, I will do that on my end
6. If necessary, rebase your commits into logical chunks, without errors
7. Push the branch up to GitHub
8. Send me (altamic) a pull request for your branch

Copyright

© Copyright 2011 Michelangelo Altamore. See LICENSE for details.