py-q4pg: A simple transactional message queue using PostgreSQL in Python.
Lots of things are inspired from
License: MIT
How to install py-q4pg
From pip
$ pip install py-q4pg
From easy_install
$ easy_install py-q4pg
From source
$ python ./setup.py install
Tutorial
QueueManager
import q4pg
q = q4pg.QueueManager(
dsn = 'dbname=db1 user=user', # psycopg2's dsn argument. or db-url ("postgresql://username:password@hostname:port/dbname")
table_name = 'mq', # name of the table to use. (default "mq")
data_type = 'json', # stored data type : 'json' or 'text'. (default "json")
data_length = 1023, # data string max length. (default 1023)
excepted_times_to_ignore = 0) # The queue excepted more than this times will be ignored
# or set 0 to not ignore any queue. (default 0)Manipurations
Each manipurations create a session object used for DB access iternal. And You can also give the session object as the last argument of each function. If you give your session object You must commit() after enqueue / dequeue.
To create queue table
q.create_table()
###
q.create_table(other_session) # create_table by using other session.enqueue
q.enqueue('tag', {'the_data': 'must_be'})
q.enqueue('tag', {'json': 'serializable_data'})
q.enqueue('tag', {'more': 'data'})
###
q.enqueue('tag', {'the_data': 'must_be'}, other_session) # enqueue by using other session.dequeue
with q.dequeue('tag') as dq:
print dq
# => {'the_data': 'must_be'}
with q.dequeue('another-tag') as dq:
print dq
# => None
###
q.dequeue('tag', other_session) # dequeue by using other session.dequeue-line
with q.dequeue_item('tag') as dq:
print dq
# => (1, 'tag', '{"the_data":"must_be"}', datetime.datetime(...), 0)
with q.dequeue_item('another-tag') as dq:
print dq
# => None
#
# this also can use other session (optional).show list
q.list('tag')
# => [ (2, 'tag', '{"json":"serializable_data"}', datetime.datetime(...), 0),
# (3, 'tag', '{"more":"data"}', datetime.datetime(...), 0), ]
#
# this also can use other session (optional).dequeue (transactional)
# dequeue() is transactional.
# if you abort in the with statement,
# the queue is remained and can be gotten other runner or next time.
with q.dequeue('tag') as dq:
print dq
x = ( 1 / 0 ) # <= Error
# => {'json': 'serializable_data'}
# => !!! Zero devision Error !!!
q.list('tag')
# => [ (3, 'tag', '{"more":"data"}', datetime.datetime(...), 0),
# (2, 'tag', '{"json":"serializable_data"}', datetime.datetime(...), 1), ] <= remained and push tail.
# ^^^ <= error counter is incremented.
# this also can use other session (optional).dequeue (listen)
for i in q.listen('tag'): # waiting for queue notification.
print i
# => ... waiting for a queue ...
>>> q.enqueue('tag', {'foo', 'bar'}) # someone push a queue.
# => {'foo', 'bar'} # get queue immediately
# => ... waiting for next queue ...
# listen() is also transactional.
# So if you abort in the for loop,
# the queue is remained and can be gotten other runner or next time.dequeue-item (listen)
for i in q.listen_item('tag'): # waiting for queue notification.
print i
# => (1, 'tag', {'foo', 'bar'}, datetime.datetime(...), 0)
#
# this also can use other session (optional).dequeue and dequeue-item (listen with timeout)
for i in q.listen('tag', timeout=1): # if timeout (sec) is specified and expired it then returns None. listen_item() is also usable this.
print i
# => None # if timeouted. (1 second past without enqueue)dequeue (immediate)
q.dequeue_immediate('tag') # removed immediately, not transactional.
# => {'json': 'serializable_data'}
#
# this also can use other session (optional).dequeue-item (immediate)
q.dequeue_item_immediate('tag') # removed immediately, not transactional.
# => (1, 'tag', {'json': 'serializable_data'}, datetime.datetime(...), 1)
#
# this also can use other session (optional).counting items
q.count('tag')
# => 1 # the number of remainder queue.
#
# this also can use other session (optional).cancel
q.cancel(3) # specify id of queue.
# => True # success.
q.cancel(3)
# => False # failed to cancel or not found the queue.
#
# this also can use other session (optional).