diff --git a/coolamqp/__init__.py b/coolamqp/__init__.py index 77f1c8e63c9e11b968a1e66b0efebd57ee2a9240..a790050877d8a8b41632471a0228d1ffa856d5bc 100644 --- a/coolamqp/__init__.py +++ b/coolamqp/__init__.py @@ -1 +1 @@ -__version__ = '1.5.0' +__version__ = '2.0.0a1' diff --git a/docs/index.rst b/docs/index.rst index f7237ce1327a5e9ff07f2fef4c5f7cd082bda8b7..626a0b774f67c40c03a2b120a637dbdf8c57344a 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -5,6 +5,7 @@ Welcome to CoolAMQP's documentation! :maxdepth: 2 :caption: Contents + whatsnew cluster tutorial caveats diff --git a/docs/whatsnew.rst b/docs/whatsnew.rst new file mode 100644 index 0000000000000000000000000000000000000000..4e2b86d9feeffb1bc98f317a59794e7e82ffe835 --- /dev/null +++ b/docs/whatsnew.rst @@ -0,0 +1,30 @@ +What's new? What's new? +=========== + +CoolAMQP 2.0.0 marks a slight philosophy shift. Whereas 1.x used auto-generated UUID names, 2.0 will let the server +pick their names for themselves. + +It also forbids some combinations of Queue arguments, and makes the default values more palatable, so for example +a naked :class:`coolamqp.objects.Queue` will be anonymous, non-durable, exclusive and auto-delete. + +Queues +------ + +Following queues will fail now: + +* auto_delete and durable +* anonymous and durables +* anonymous and not exclusives +* anonymous and not auto_delete +* auto_delete and not exclusive and not anonymous + +Following will emit a warning: + +* exclusive and auto_delete - DeprecationWarning, since they're removing it in RabbitMQ 4.0 +* not anonymous, auto_delete and not exclusive - UserWarning, since this makes little sense + +Anonymous queues +---------------- + +They are back. Besides, anything that you will pass to :meth:`coolamqp.clustering.Cluster.consume` will be declared, be +it an exchange, a queue or such shit. This allows you to declare anonymous queues.