Go Shell
Latest commit afe8eee Mar 13, 2017 @michaelklishin michaelklishin committed on GitHub Merge pull request #250 from domodwyer/bugfix/channel-allocation-leak
Avoid leaking channel allocations in Connection.openChannel()
Permalink
Failed to load latest commit information.
_examples gofmt and label rename Dec 5, 2016
spec Refactor to fix all but the Id -> ID lint errors Dec 5, 2016
.gitignore Ignore ./certs Nov 24, 2016
.travis.yml Add go 1.8 explicitly in Travis CI, tip is now go 1.9 Mar 3, 2017
CONTRIBUTING.md Run golint/go vet in CI Dec 5, 2016
LICENSE Add 2 Clause BSD license Jul 10, 2012
README.md Fix external package links Nov 25, 2016
allocator.go tivial spelling fixes Jul 17, 2016
allocator_test.go Run golint and go vet in pre-commit Dec 5, 2016
auth.go Refactor to fix all but the Id -> ID lint errors Dec 5, 2016
certs.sh Rotate certs with 10 year lifetime Jan 27, 2014
channel.go Merge branch 'consumer_cancel_notifications' Dec 10, 2016
client_test.go Fix most `go vet` errors Dec 5, 2016
confirms.go call resequense() for multiple publisher confirmations Feb 25, 2017
confirms_test.go golint Feb 25, 2017
connection.go Release the allocated channel when sending the channel open frame fai… Mar 13, 2017
connection_test.go Release the allocated channel when sending the channel open frame fai… Mar 13, 2017
consumers.go Refactor to fix all but the Id -> ID lint errors Dec 5, 2016
delivery.go Refactor to fix all but the Id -> ID lint errors Dec 5, 2016
delivery_test.go Errors instead of panics on closed delivery chan Dec 1, 2014
doc.go Refactor to fix all but the Id -> ID lint errors Dec 5, 2016
examples_test.go Fix godoc DialTLS Example Dec 22, 2016
fuzz.go the +build tag isn't a doc comment Oct 31, 2016
gen.sh Use the BSD licensed amqp091 spec. Aug 10, 2013
integration_test.go Test for consumer cancel notifications Dec 10, 2016
pre-commit Go vet fixed in #238 Feb 3, 2017
read.go Refactor to fix all but the Id -> ID lint errors Dec 5, 2016
read_test.go Run golint and go vet in pre-commit Dec 5, 2016
reconnect_test.go Cleanup printfs found with go vet May 25, 2013
return.go tivial spelling fixes Jul 17, 2016
shared_test.go Fix most `go vet` errors Dec 5, 2016
spec091.go Refactor to fix all but the Id -> ID lint errors Dec 5, 2016
tls_test.go Interface compatibility with *tls.Conn Dec 5, 2016
types.go Refactor to fix all but the Id -> ID lint errors Dec 5, 2016
uri.go Error if URI contains whitespaces Mar 3, 2017
uri_test.go Remove commented URI test Mar 3, 2017
write.go Refactor to fix all but the Id -> ID lint errors Dec 5, 2016

README.md

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 over 3 years. It is reasonably mature and feature complete, and as of November 2016 has a team of maintainers instead of being a one man show.

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

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.

Continuous Integration

Build Status

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.