Skip to content

Commit

Permalink
Add new qgisapp Python context manager for creating QGIS apps
Browse files Browse the repository at this point in the history
  • Loading branch information
NathanW2 committed May 20, 2014
1 parent 938f288 commit 19e727e
Showing 1 changed file with 41 additions and 0 deletions.
41 changes: 41 additions & 0 deletions python/core/contextmanagers.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
import sys
from contextlib import contextmanager
from qgis.core import QgsApplication


@contextmanager
def qgisapp(args=None, guienabled=True, configpath=None, sysexit=True):
"""
Create a new QGIS Qt application.
You should use this before creating any Qt widgets or QGIS objects for
your custom QGIS based application.
usage:
from qgis.core.contextmanagers import qgisapp
def main(app):
# Run your main code block
with qgisapp(sys.argv) as app:
main(app)
args - args passed to the underlying QApplication.
guienabled - True by default will create a QApplication with a GUI. Pass
False if you wish to create no GUI based app, e.g a server app.
configpath - Custom config path QGIS will use to load settings.
sysexit - Call sys.exit on app exit. True by default.
"""
if not args:
args = []
app = QgsApplication(args, guienabled, configpath)
QgsApplication.initQgis()
yield app
if guienabled:
exitcode = app.exec_()
else:
exitcode = 0
QgsApplication.exitQgis()
if sysexit:
sys.exit(exitcode)

0 comments on commit 19e727e

Please sign in to comment.