tile38/vendor/github.com/streadway/amqp
Josh Baker 26d0083faf Update vendoring to use golang/dep
commit a1a37d335a8e89ac89d85c00c8585d3fc02e064a
Author: Josh Baker <joshbaker77@gmail.com>
Date:   Thu Oct 5 07:36:54 2017 -0700

    use symlink instead of copy

commit 96399c2c92620f633611c778e5473200bfd48d41
Author: Josh Baker <joshbaker77@gmail.com>
Date:   Thu Oct 5 07:19:26 2017 -0700

    use dep for vendoring
2017-10-05 07:40:19 -07:00
..
_examples Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
spec AMQP webhook support () 2017-03-15 10:45:35 -07:00
.gitignore Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
.travis.yml Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
CONTRIBUTING.md AMQP webhook support () 2017-03-15 10:45:35 -07:00
LICENSE AMQP webhook support () 2017-03-15 10:45:35 -07:00
README.md Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
allocator.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
allocator_test.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
auth.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
certs.sh AMQP webhook support () 2017-03-15 10:45:35 -07:00
channel.go Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
client_test.go Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
confirms.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
confirms_test.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
connection.go Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
connection_test.go Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
consumers.go Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
delivery.go Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
delivery_test.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
doc.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
examples_test.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
fuzz.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
gen.sh AMQP webhook support () 2017-03-15 10:45:35 -07:00
integration_test.go Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
pre-commit AMQP webhook support () 2017-03-15 10:45:35 -07:00
read.go Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
read_test.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
reconnect_test.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
return.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
shared_test.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
spec091.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
tls_test.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
types.go AMQP webhook support () 2017-03-15 10:45:35 -07:00
uri.go Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
uri_test.go Update vendoring to use golang/dep 2017-10-05 07:40:19 -07:00
write.go AMQP webhook support () 2017-03-15 10:45:35 -07:00

README.md

Build Status GoDoc

Go RabbitMQ Client Library

This is an AMQP 0.9.1 client with RabbitMQ extensions in Go.

Project Maturity

This project has been used in production systems for many years. It is reasonably mature and feature complete, and as of November 2016 has a team of maintainers.

Future API changes are unlikely but possible. They will be discussed on Github issues along with any bugs or enhancements.

Supported Go Versions

This library supports two most recent Go release series, currently 1.8 and 1.9.

Supported RabbitMQ Versions

This project supports RabbitMQ versions starting with 2.0 but primarily tested against reasonably recent 3.x releases. Some features and behaviours may be server version-specific.

Goals

Provide a functional interface that closely represents the AMQP 0.9.1 model targeted to RabbitMQ as a server. This includes the minimum necessary to interact the semantics of the protocol.

Non-goals

Things not intended to be supported.

  • Auto reconnect and re-synchronization of client and server topologies.
    • Reconnection would require understanding the error paths when the topology cannot be declared on reconnect. This would require a new set of types and code paths that are best suited at the call-site of this package. AMQP has a dynamic topology that needs all peers to agree. If this doesn't happen, the behavior is undefined. Instead of producing a possible interface with undefined behavior, this package is designed to be simple for the caller to implement the necessary connection-time topology declaration so that reconnection is trivial and encapsulated in the caller's application code.
  • AMQP Protocol negotiation for forward or backward compatibility.
    • 0.9.1 is stable and widely deployed. Versions 0.10 and 1.0 are divergent specifications that change the semantics and wire format of the protocol. We will accept patches for other protocol support but have no plans for implementation ourselves.
  • Anything other than PLAIN and EXTERNAL authentication mechanisms.
    • Keeping the mechanisms interface modular makes it possible to extend outside of this package. If other mechanisms prove to be popular, then we would accept patches to include them in this package.

Usage

See the 'examples' subdirectory for simple producers and consumers executables. If you have a use-case in mind which isn't well-represented by the examples, please file an issue.

Documentation

Use Godoc documentation for reference and usage.

RabbitMQ tutorials in Go are also available.

Contributing

Pull requests are very much welcomed. Create your pull request on a non-master branch, make sure a test or example is included that covers your change and your commits represent coherent changes that include a reason for the change.

To run the integration tests, make sure you have RabbitMQ running on any host, export the environment variable AMQP_URL=amqp://host/ and run go test -tags integration. TravisCI will also run the integration tests.

Thanks to the community of contributors.

External packages

License

BSD 2 clause - see LICENSE for more details.