Python web framework with full-stack layer implemented on top of a microframework core with support for SQL DBMS, MongoDB and Pluggable Applications
TurboGears ==========
.. image:: https://github.com/TurboGears/tg2/actions/workflows/run-tests.yml/badge.svg :target: https://github.com/TurboGears/tg2/actions/workflows/run-tests.yml
.. image:: https://coveralls.io/repos/TurboGears/tg2/badge.svg?branch=development :target: https://coveralls.io/r/TurboGears/tg2?branch=development
.. image:: https://img.shields.io/pypi/v/TurboGears2.svg :target: https://pypi.python.org/pypi/TurboGears2
.. image:: https://img.shields.io/pypi/pyversions/TurboGears2.svg :target: https://pypi.python.org/pypi/TurboGears2
.. image:: https://img.shields.io/pypi/l/TurboGears2.svg :target: https://pypi.python.org/pypi/TurboGears2
.. image:: https://www.codetriage.com/turbogears/tg2/badges/users.svg :target: https://www.codetriage.com/turbogears/tg2
.. image:: https://img.shields.io/gitter/room/turbogears/Lobby.svg :target: https://gitter.im/turbogears/Lobby
.. image:: https://img.shields.io/twitter/follow/turbogearsorg.svg?style=social&label=Follow :target: https://twitter.com/turbogearsorg
.. raw:: html 
TurboGears is a hybrid web framework able to act both as a Full Stack framework or as a Microframework. TurboGears helps you get going fast and gets out of your way when you want it!
TurboGears can be used both as a full stack framework or as a microframework in single file mode.
The following content covers examples in minimal mode, to see an example for full stack capabilities take a look at tg.devtools <https://github.com/turboGears/tg2devtools>_
Get Started
.. image:: https://asciinema.org/a/181221.png :target: https://asciinema.org/a/181221?autoplay=1
To try TurboGears just get `pip if you don't already have it::
$ curl -O 'https://bootstrap.pypa.io/get-pip.py' $ python get-pip.py
And install Turbogears::
$ pip install TurboGears2
Then serving a TurboGears web application is as simple as making a webapp.py file with your application::
from wsgiref.simpleserver import makeserver from tg import MinimalApplicationConfigurator from tg import expose, TGController
# RootController of our web app, in charge of serving content for / class RootController(TGController): @expose(c) def index(self): return 'Hello World'
# Configure a new minimal application with our root controller. config = MinimalApplicationConfigurator() config.update_blueprint({ 'root_controller': RootController() })
# Serve the newly configured web application. print("Serving on port 8080...") httpd = makeserver('', 8080, config.makewsgi_app()) httpd.serve_forever()
Start it with python webapp.py and open your browser at http://localhost:8080/
Want to play further with TurboGears? Try the TurboGears Tutorials:
- Getting Started with Turbogears
_ - Building a Wiki in 20 minutes
_
Visit TurboGears Documentation _ for complete documentation and tutorials.
See the TurboGears website
License
TurboGears is licensed under an MIT-style license (see LICENSE.txt). Other incorporated projects may be licensed under different licenses. All licenses allow for non-commercial and commercial use.