rq/CHANGES.md

0.4.0

(not released yet)

• Job dependencies! Thanks, Selwin.

• Queue.all() and rqinfo now report empty queues, too. Thanks, Rob!

• Fixed a performance issue in Queue.all() when issued in large Redis DBs. Thanks, Rob!

• Birth and death dates are now stored as proper datetimes, not timestamps.

• Ability to provide a custom job description (instead of using the default function invocation hint). Thanks, İbrahim.

• Fix: temporary key for the compact queue is now randomly generated, which should avoid name clashes for concurrent compact actions.

• Fix: Queue.empty() now correctly deletes job hashes from Redis.

0.3.11

(August 23th, 2013)

• Some more fixes in command line scripts for Python 3

0.3.10

(August 20th, 2013)

• Bug fix in setup.py

0.3.9

(August 20th, 2013)

• Python 3 compatibility (Thanks, Alex!)

• Minor bug fix where Sentry would break when func cannot be imported

0.3.8

(June 17th, 2013)

• rqworker and rqinfo have a --url argument to connect to a Redis url.

• rqworker and rqinfo have a --socket option to connect to a Redis server through a Unix socket.

• rqworker reads SENTRY_DSN from the environment, unless specifically provided on the command line.

• Queue has a new API that supports paging get_jobs(3, 7), which will return at most 7 jobs, starting from the 3rd.

0.3.7

(February 26th, 2013)

• Fixed bug where workers would not execute builtin functions properly.

0.3.6

(February 18th, 2013)

• Worker registrations now expire. This should prevent rqinfo from reporting about ghosted workers. (Thanks, @yaniv-aknin!)

• rqworker will automatically clean up ghosted worker registrations from pre-0.3.6 runs.

• rqworker grew a -q flag, to be more silent (only warnings/errors are shown)

0.3.5

(February 6th, 2013)

• ended_at is now recorded for normally finished jobs, too. (Previously only for failed jobs.)

• Adds support for both Redis and StrictRedis connection types

• Makes StrictRedis the default connection type if none is explicitly provided

0.3.4

(January 23rd, 2013)

• Restore compatibility with Python 2.6.

0.3.3

(January 18th, 2013)

• Fix bug where work was lost due to silently ignored unpickle errors.

• Jobs can now access the current Job instance from within. Relevant documentation here.

• Custom properties can be set by modifying the job.meta dict. Relevant documentation here.

• Custom properties can be set by modifying the job.meta dict. Relevant documentation here.

• rqworker now has an optional --password flag.

• Remove logbook dependency (in favor of logging)

0.3.2

(September 3rd, 2012)

• Fixes broken rqinfo command.

• Improve compatibility with Python < 2.7.

0.3.1

(August 30th, 2012)

• .enqueue() now takes a result_ttl keyword argument that can be used to change the expiration time of results.

• Queue constructor now takes an optional async=False argument to bypass the worker (for testing purposes).

• Jobs now carry status information. To get job status information, like whether a job is queued, finished, or failed, use the property status, or one of the new boolean accessor properties is_queued, is_finished or is_failed.

• Jobs return values are always stored explicitly, even if they have to explicit return value or return None (with given TTL of course). This makes it possible to distinguish between a job that explicitly returned None and a job that isn't finished yet (see status property).

• Custom exception handlers can now be configured in addition to, or to fully replace, moving failed jobs to the failed queue. Relevant documentation here and here.

• rqworker now supports passing in configuration files instead of the many command line options: rqworker -c settings will source settings.py.

• rqworker now supports one-flag setup to enable Sentry as its exception handler: rqworker --sentry-dsn="http://public:secret@example.com/1" Alternatively, you can use a settings file and configure SENTRY_DSN = 'http://public:secret@example.com/1' instead.

0.3.0

(August 5th, 2012)

• Reliability improvements

  • Warm shutdown now exits immediately when Ctrl+C is pressed and worker is idle
  • Worker does not leak worker registrations anymore when stopped gracefully

• .enqueue() does not consume the timeout kwarg anymore. Instead, to pass RQ a timeout value while enqueueing a function, use the explicit invocation instead:

  ```python
  q.enqueue(do_something, args=(1, 2), kwargs={'a': 1}, timeout=30)
  ```
  

• Add a @job decorator, which can be used to do Celery-style delayed invocations:

  ```python
  from redis import StrictRedis
  from rq.decorators import job
  
  # Connect to Redis
  redis = StrictRedis()
  
  @job('high', timeout=10, connection=redis)
  def some_work(x, y):
      return x + y
  ```
  

  Then, in another module, you can call some_work:

  ```python
  from foo.bar import some_work
  
  some_work.delay(2, 3)
  ```
  

0.2.2

(August 1st, 2012)

• Fix bug where return values that couldn't be pickled crashed the worker

0.2.1

(July 20th, 2012)

• Fix important bug where result data wasn't restored from Redis correctly (affected non-string results only).

0.2.0

(July 18th, 2012)

• q.enqueue() accepts instance methods now, too. Objects will be pickle'd along with the instance method, so beware.
• q.enqueue() accepts string specification of functions now, too. Example: q.enqueue("my.math.lib.fibonacci", 5). Useful if the worker and the submitter of work don't share code bases.
• Job can be assigned custom attrs and they will be pickle'd along with the rest of the job's attrs. Can be used when writing RQ extensions.
• Workers can now accept explicit connections, like Queues.
• Various bug fixes.

0.1.2

(May 15, 2012)

• Fix broken PyPI deployment.

0.1.1

(May 14, 2012)

• Thread-safety by using context locals
• Register scripts as console_scripts, for better portability
• Various bugfixes.

0.1.0:

(March 28, 2012)

• Initially released version.