Live and Let Die (former Test Live Server) is a simple package to simplify launching and terminating of web development servers from BDD or functional tests. I have created it for functional testing of the Authomatic package.
Note that the package has just recently been renamed from former testliveserver to current liveandletdie!
The package Currently supports Google App engine, Django, Flask and wsgiref.simple_server. Support for other frameworks will hopefully be added in future.
You first need to make instance of one of the framework classes.
import liveandletdie
# Django
app = liveandletdie.Django('path/to/django/project/',
host='0.0.0.0',
port=5555,
timeout=60.0)
import liveandletdie
app = liveandletdie.GAE('path/to/dev_appserver.py',
'path/to/gae/app/dir', # containing app.yaml file
host='0.0.0.0',
port=5555,
timeout=60.0)
By Flask you must wrap the WSGI application in liveandletdie.Flask.wrap(app)
.
# flask/app/main.py
from flask import Flask
DEBUG = True
SECRET_KEY = 'development key'
USERNAME = 'admin'
PASSWORD = 'default'
app = Flask(__name__)
app.config.from_object(__name__)
@app.route('/')
def home():
return 'Hello World!'
if __name__ == '__main__':
# This does nothing unless you run this module with --liveandletdie flag.
import liveandletdie
liveandletdie.Flask.wrap(app)
app.run()
import liveandletdie
app = liveandletdie.Flask('path/to/flask/app/main.py',
host='0.0.0.0',
port=5555,
timeout=60.0)
By wsgiref.simple_server
you must wrap the WSGI application in liveandletdie.WsgirefSimpleServer.wrap(app)
.
# pyramid/app/main.py
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response
def home(request):
return Response('Hello World!')
if __name__ == '__main__':
config = Configurator()
config.add_route('home', '/')
config.add_view(home, route_name='home')
app = config.make_wsgi_app()
# This does nothing unless you run this module with --liveandletdie flag.
import liveandletdie
liveandletdie.WsgirefSimpleServer.wrap(app)
server = make_server('127.0.0.1', 8080, app)
server.serve_forever()
import liveandletdie
app = liveandletdie.Flask('path/to/pyramid/app/main.py',
host='0.0.0.0',
port=5555,
timeout=60.0)
The interface is the same for all of the supported frameworks.
# Start the app.
# If kill is True, it will kill any Python process listening on port 5555
process = app.live(kill=True)
# You can check whether it is running
is_running = app.check()
# Stop it
app.die()
Simple UnitTest example: https://github.com/peterhudec/liveandletdie/blob/master/test_examples/unittest_example/tests.py
Simple PyTest example: https://github.com/peterhudec/liveandletdie/blob/master/test_examples/pytest_example/tests.py
Simple Lettuce example: https://github.com/peterhudec/liveandletdie/blob/master/test_examples/lettuce_example/tests.py
Clone:
$ git clone https://github.com/peterhudec/liveandletdie.git
Bootstrap the development environment. This will create the ./venv
virtual environment in the project root.
$ sh bootstrap.sh
Run tests:
$ sh run-all.sh
Or bootstrap and run tests in one step:
$ sh bootstrap-and-test.sh
Enjoy!