Kombu: Documentation - pyamqp vs amqp vs librabbitmq

[cyounkins]

The documentation is confusing about which AMQP transport to use.

• Should I use amqp://, pyamqp://, or librabbitmq://.
• Should I install PyPi package amqp or pyamqp? If I specify pyamqp, which one is it using?
• Does the C librabbitmq come in the mongodb package from 10gen? Are there any packages for it for common platforms, or do you have to compile it yourself? http://hg.rabbitmq.com/rabbitmq-c/

Write something here and I'll make a pull request to change the documentation. Thanks!

[ask]

1. amqp:// is an alias that uses librabbitmq if available, or py-amqp if it's not.
   You'd use pyamqp:// or librabbitmq:// if you want to specify exactly what transport to use.
2. From Kombu 2.5 it depends on the 'amqp' package by default, so you shouldn't have to install it manually.
   The pyamqp:// transport uses the 'amqp' library (http://github.com/celery/py-amqp)
3. librabbitmq is not related to mongodb, and is not used by the mongodb transport, so it's unlikely to be included in any mongodb distribution.

When you do 'pip install librabbitmq' it will automatically compile the rabbitmq-c library, so you don't need to have it installed.

[cyounkins]

I was really tired when I wrote that. Of course librabbitmq doesn't come with mongodb. -_- You answered my question though, saying that it is installed with librabbitmq. I will update docs and send a pull req. Thanks.