glossary.rst 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
  1. .. _glossary:
  2. Glossary
  3. ========
  4. .. glossary::
  5. :sorted:
  6. acknowledged
  7. Workers acknowledge messages to signify that a message has been
  8. handled. Failing to acknowledge a message
  9. will cause the message to be redelivered. Exactly when a
  10. transaction is considered a failure varies by transport. In AMQP the
  11. transaction fails when the connection/channel is closed (or lost),
  12. but in Redis/SQS the transaction times out after a configurable amount
  13. of time (the ``visibility_timeout``).
  14. ack
  15. Short for :term:`acknowledged`.
  16. request
  17. Task messages are converted to *requests* within the worker.
  18. The request information is also available as the task's
  19. :term:`context` (the ``task.request`` attribute).
  20. calling
  21. Sends a task message so that the task function is
  22. :term:`executed <executing>` by a worker.
  23. executing
  24. Workers *execute* task :term:`requests <request>`.
  25. apply
  26. Originally a synonym to :term:`call <calling>` but used to signify
  27. that a function is executed by the current process.
  28. context
  29. The context of a task contains information like the id of the task,
  30. it's arguments and what queue it was delivered to.
  31. It can be accessed as the tasks ``request`` attribute.
  32. See :ref:`task-request-info`
  33. idempotent
  34. Idempotence is a mathematical property that describes a function that
  35. can be called multiple times without changing the result.
  36. Practically it means that a function can be repeated many times without
  37. unintented effects, but not necessarily side-effect free in the pure
  38. sense (compare to :term:`nullipotent`).
  39. nullipotent
  40. describes a function that will have the same effect, and give the same
  41. result, even if called zero or multiple times (side-effect free).
  42. A stronger version of :term:`idempotent`.