File: README.md

package info (click to toggle)
ruby-amq-protocol 0.9.2-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 392 kB
  • sloc: ruby: 4,212; python: 247; makefile: 2
file content (43 lines) | stat: -rw-r--r-- 1,358 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# What is amq-protocol.

amq-protocol is an AMQP 0.9.1 serialization library for Ruby. It is not an
AMQP client: amq-protocol only handles serialization and deserialization.
If you want to write your own AMQP client, this gem can help you with that.

## How does amq-protocol relate to amqp gem, amq-client and libraries like bunny?

See [this page about AMQP gems family](https://github.com/ruby-amqp/amq-client/blob/master/README.textile)


## Installation

    gem install amq-protocol


## Development

Make sure you have Python and the mako templating package installed. amq-protocol uses RabbitMQ protocol
code generation library that is in Python, so there is some Python involved in the build. Don't fret.

To regenerate `lib/amq/protocol/client.rb` from the source (`protocol.rb.pytemplate`), run

    ./generate.rb

To make changes, **do not edit client.rb directly**. Instead, edit `protocol.rb.pytemplate` and regenerate.

To run tests, use

    bundle install --binstubs
    ./bin/rspec -c spec spec


## Maintainer Information

amq-protocol is maintained by [Michael Klishin](https://github.com/michaelklishin).


## Links

 * [Continous integration server](http://travis-ci.org/#!/ruby-amqp/amq-protocol)
 * [Ruby AMQP mailing list](http://groups.google.com/group/ruby-amqp)
 * [Issue tracker](http://github.com/ruby-amqp/amq-protocol/issues)