Fedora-messaging

Bug Fixes

- Set the QoS on the channel that is created for the consumer
(223)


Documentation Improvements

- When running `fedora-messaging consume`, the callback module should
not contain a call to `api.consume()` or it will block.
([df4055f](https://github.com/fedora-infra/fedora-messaging/commit/df4055f))

- Update the schema docs
(PR 219)

- Fix quickstart cert file links
(PR 222)

- Fix the docs about exceptions being wrapped by HaltConsumer
(215)


Other Changes

- Only try to restart fm-consumer services every 60 seconds
(PR 214)

Bug Fixes

- Fix handling of new connections after a publish timeout
(212)

Dependency Changes

- Drop official Python 3.4 and 3.5 support
- Bump the pika requirement to 1.0.1+
- New dependency: [Crochet](https://crochet.readthedocs.io/en/stable/)


API Changes

- Move all APIs to use the Twisted-managed connection. There are a few minor
changes here which slightly change the APIs:

1. Publishing now raises a PublishTimeout when the timeout is reached
(30 seconds by default).
2. Previously, the Twisted consume API did not validate arguments like
the synchronous version did, so it now raises a ValueError on invalid
arguments instead of crashing in some undefined way.
3. Calling publish from the Twisted reactor thread now raises an
exception instead of blocking the reactor thread.
4. Consumer exceptions are not re-raised as `HaltConsumer` exceptions
anymore, the original exception bubbles up and has to be handled by the
application.


Features

- The `fedora-messaging` cli now has 2 new sub-commands: `publish` and `record`.
(PR 43)
- Log the failure traceback on connection ready failures.


Bug Fixes

- Fix an issue where reconnection to the server would fail.
(208)
- Don't declare exchanges when consuming.
(171)
- Fix Twisted legacy logging (it does not accept format parameters).
- Handle ConnectionLost errors in the v2 Factory.


Development Changes

- Many Twisted-related tests were added.
- Include tests for sample schema package.
- Update the dumps and loads functions for a new message format.


Documentation Improvements

- Document that logging is only set up for consumers.
- Update the six intersphinx URL to fix the docs build.
- Add the "conf" and "DEFAULTS" variables to the API documentation.
- Update example config: extra properties, logging.
- Document a quick way to setup logging.
- Document the sent-at header in messages.
- Create a quick-start guide.
- Clarify queues are only deleted if unused.
- Wire-format: improve message properties documentation.
- Note the addition client properties in the config docs.


Contributors

Many thanks to the contributors of bug reports, pull requests, and pull request
reviews for this release:

- Aurélien Bompard
- Adam Williamson
- dvejmz
- Jeremy Cline
- Randy Barlow
- Shraddha Agrawal
- Sebastian Wojciechowski

Bug Fixes

- Fix variable substitution in log messages.
(PR 200)
- Add MANIFEST.in and include tests for sample schema package.
(PR 197)


Documentation Improvements

- Document the sent-at header in messages.
(PR 199)
- Create a quick-start guide.
(PR 196)


Contributors
Many thanks to the contributors of bug reports, pull requests, and pull request
reviews for this release:

- Adam Williamson
- Aurélien Bompard
- Jeremy Cline
- Shraddha Agrawal

Bug Fixes

- Don't declare exchanges when consuming using the synchronous
`fedora_messaging.api.consume()` API, which was causing consuming to fail
from the Fedora broker
(PR 191)

Contributors
Many thanks to the contributors of bug reports, pull requests, and pull request
reviews for this release:

- Randy Barlow
- Aurélien Bompard
- Jeremy Cline
- Adam Williamson


Documentation Improvements

- Document some additional app properties and add a note about setting up logging
in the fedora.toml and stg.fedora.toml configuration files
(PR 188)

- Document how to setup logging in the consuming snippets so any problems are
logged to stdout
(PR 192)

- Document that logging is only set up for consumers
(181)

- Document the `fedora_messaging.config.conf` and
`fedora_messaging.config.DEFAULTS` variables in the API documentation
(182)

Features

- "fedora-messaging consume" now accepts a "--callback-file" argument which will
load a callback function from an arbitrary Python file. Previously, it was
required that the callback be in the Python path
(159).


Bug Fixes

- Fix a bug where publishes that failed due to certain connection errors were not
retried
(175).

- Fix a bug where AMQP protocol errors did not reset the connection used for
publishing messages. This would result in publishes always failing with a
ConnectionError
(178).


Documentation Improvements

- Document the `body` attribute on the `Message` class
(164).

- Clearly document what properties message schema classes should override
(166).

- Re-organize the consumer documentation to make the consuming API clearer
(168).


Contributors
Many thanks to the contributors of bug reports, pull requests, and pull request
reviews for this release:

- Randy Barlow
- Aurélien Bompard
- Jeremy Cline
- Dusty Mabe