This document outlines some of the common pitfalls you may encounter when getting set up with huey. It is arranged in a problem/solution format.
First step is to increase logging verbosity by running the consumer with --verbose. You can also specify a logfile using the --logfile option.
Check for any exceptions. The most common cause of tasks not running is that they are not being loaded, in which case you will see QueueException “XXX not found in TaskRegistry” errors.
Exception occurs when a task is called by a task producer, but is not imported by the consumer. To fix this, ensure that by loading the Huey object, you also import any decorated functions as well.
For more information on how tasks are imported, see the docs
This error message occurs when the module containing the configuration specified cannot be loaded (not on the pythonpath, mistyped, etc). One quick way to check is to open up a python shell and try to import the configuration.
Example syntax: huey_consumer.py main_module.huey