QBall python integration
Run a qball (https://github.com/ferrants/qball) instance somewhere. Use it in python with this repo.
Install
$ pip install qball
# or
$ pip install git+ssh://git@github.com/ferrants/qball-python.git@master --upgrade
Use in script
from qball.qball import QBall
from qball.qball import QBallException
# no exception handling - server must be alive or an exception will be thrown
qball = QBall('http://localhost', 8080, 'ball', timeout=2, log_level=1)
print "before block"
with qball:
print "in block"
time.sleep(5)
print "out of block"
# will throw QBallException if it can't connect
qball = QBall('http://localhost', 8080, 'ball', timeout=2, log_level=1)
print "before block"
try:
with qball:
print "in block"
time.sleep(5)
except QBallException:
print "QBallException caught"
# will not throw a QBallException if allow_no_connect is true
qball = QBall('http://localhost', 8080, 'ball', timeout=2, log_level=0, allow_no_connect=True)
with qball:
print "HERE"
Options
Defaults shown below
-
user_name=False- what user_name to register with when waiting. will auto-generate from the key_prefix and a random number if not used -
timeout=10- how often to check back with qball -
key_prefix='qball-python_'- prefix for auto-generated user ids -
log_level=0= how much to log. 1 will show everything, 0 shows only a little -
allow_no_connect=False- If your qball instance may go down and you don't want to allow execution to continue without error handling, set this to true
