paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-11-04 14:03:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Document the new queue_json_publish model in our unit tests.

Browse Source
This commit is contained in:
Tim Abbott
2017-11-26 11:49:42 -08:00
parent 9fcdb6c83a
commit c3c978e55d
1 changed files with 10 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/subsystems/queuing.md
View File

@@ -64,6 +64,16 @@ manually.
You can publish events to a RabbitMQ queue using the You can publish events to a RabbitMQ queue using the
`queue_json_publish` function defined in `zerver/lib/queue.py`. `queue_json_publish` function defined in `zerver/lib/queue.py`.
An interesting challenge with queue processors is what should happen
when queued events in Zulip's backend tests. Our current solution is
that in the tests, `queue_json_publish` will (by default) simple call
the `consume` method for the relevant queue processor. However,
`queue_json_publish` also supports being passed a function that should
be called in the tests instead of the queue processor's `consume`
method. Where possible, we prefer the model of calling `consume` in
tests since that's more predictable and automatically covers the queue
processor's code path, but it isn't always possible.
### Clearing a RabbitMQ queue ### Clearing a RabbitMQ queue
If you need to clear a queue (delete all the events in it), run If you need to clear a queue (delete all the events in it), run