Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Scheduling for rq.

Project description

hourglass is a minimalist scheduler for rq.

hourglass provides a date-sorted queue class, Schedule, that stores jobs that are to be run at some point in the future, and a daemon script, hourglass, that delegates those jobs to the regular queues processed by rqworker processes.


Run the hourglass daemon script included with the package. Example usage:

import times
from datetime import timedelta
from rq import use_connection
from hourglass import Schedule

def test_job(n):
    return n


s = Schedule()

# schedule a job to be run 3 minutes from now
eta = + timedelta(0, 180)
job = s.enqueue(eta, test_job, 5)

hourglass managed jobs include an additional property, eta, which is the time passed as the first argument to Schedule.enqueue and Schedule.enqueue_job. They also include another property, queue for specifying which queue to dispatch the job to when eta has elapsed.

The Schedule queue and hourglass daemon use UTC times under the hood, so eta’s passed to the scheduler should be in UTC as well.



Compatibility updates for rq-0.3.0


Made Schedule.enqueue_job and Schedule.compact atomic.


Fixes for Python packaging.


Initial release.

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
hourglass-0.2.tar.gz (6.7 kB) Copy SHA256 hash SHA256 Source None Aug 6, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page