Skip to content

Latest commit

 

History

History
55 lines (41 loc) · 1.14 KB

msgpack.org.md

File metadata and controls

55 lines (41 loc) · 1.14 KB

MessagePack for Ruby

require 'msgpack'
msg = [1,2,3].to_msgpack  #=> "\x93\x01\x02\x03"
MessagePack.unpack(msg)   #=> [1,2,3]

Install

Add msgpack to your Gemfile to install with Bundler:

# Gemfile
gem 'msgpack'

Or, use RubyGems to install:

gem install msgpack

Use cases

  • Create REST API returing MessagePack using Rails + RABL
  • Store objects efficiently in memcached or Redis
  • Upload data in efficient format from mobile devices. See also MessagePack for Objective-C and Java

Links

Streaming API

# serialize a 2-element array [e1, e2]
pk = MessagePack::Packer.new(io)
pk.write_array_header(2).write(e1).write(e2).flush
# deserialize objects from an IO
u = MessagePack::Unpacker.new(io)
u.each { |obj| ... }
# event-driven deserialization
def on_read(data)
  @u ||= MessagePack::Unpacker.new
  @u.feed_each(data) { |obj| ... }
end