This is a quick introduction about TurboGears2 , a full-stack framework for Python
TurboGears is a full-stack framework, a battery-included framework in other workds ..actually this is TurboGears 2 which is a reinvention of the original turbogears project to make use of the new components and give you a fully customizable WSGI server.
A minimal installation of TurboGears is done by
pip install TurboGears2
To install TurboGears along with development tools, use
pip install tg.devtools
Before, it's better to setup a virtual environment by using
to activate the virtual environment, and if you don't have pipenv, you can install simply by:
pip install pipenv
TurboGears has a minimal mode that makes it possible to create single file applications quickly.
Simple examples and services can be built quickly with minimal set of dependencies.
from tg import expose, TGController
A class in a turbogears application is inherited from TGController Parent class. class MyController(TGController):
Methods in this class are available for access by @expose decorator from tg module. @expose()
In our first application, index() method is mapped as root of our application.
The TGController class also needs to be imported from tg module.
return 'Hello, TurboGears'
config = AppConfig(minimal = True, root_controller = MyController())
The make_wsgi_app() function here constructs application object.
application = config.make_wsgi_app()
In order to serve this application, we need to start the HTTP server.
You can use simple_server module in wsgiref package to set up and start it.
from wsgiref.simple_server import make_server
This module has make_server() method which requires port number and application object as arguments.
server = make_server('', 8080, application)
Then run your app
Nothing will tell you that the app is running on whatever port , so you'll need to open the browser and check out on port 8080.
The tg.devtools of TurboGears contains Gearbox.
It is a set of commands, which are useful for management of more complex TG projects.
Full stack projects can be quickly created by the following Gearbox command
gearbox quickstart HelloWorld
This will create a project called HelloWorld
A TurboGears project contains the following directories −
Config − Where project setup and configuration relies
Controllers − All the project controllers, the logic of web application
i18n − Translation files for the languages supported
Lib − Utility python functions and classes
Model − Database models
Templates − Templates exposed by our controllers.
Tests − The set of Tests done.
Websetup − Functions to execute at application setup.
This project now needs to be installed.
A setup.py is already provided in project’s base directory.
Project dependencies get installed when this script is executed.
Python setup.py develop
By default, following dependencies are installed at the time of project set up −
tgext.admin ≥ 0.6.1
After installation, start serving the project on development server by issuing following command in shell −
Gearbox serve -–reload -–debug
This sample application gives a brief introduction about TurboGears framework itself.
Thank you for reading till the end.