Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Torneira is a lightweight and rapid web framework build on top of Tornado

This branch is 1 commit ahead and 2 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.rst

Torneira - Lightweight Web Framework

Torneira is a lightweight web framework build on top of Tornado. It's name came from the idea of getting rapid and fluid development ('torneira' is the portuguese word for water tap).

Build Status

Installation

Torrneira is available under PyPI. You can install using pip:

$ pip install torneira

Quick start

To build an app using torneira, you just need 3 files: one for your urls definitions (normally urls.py), one for settings (settings.py) and another for your handlers (handlers.py). The Application and HTTPServer stuff is already setup to you.

To start the server on por 8888, just run the following command in the base directory of your app:

$ torneira

In the directory demos/simple_app/ there is a minimal app already configured. If you want to see a more complex app that uses more available features, take a look at demos/more_complex_app.

To see all options that torneira command support, run:

$ torneira --help

Contributing

Send a pull request (preferred) or patches using git format-patch. Also, torneira comes with some tests in tests/ directory. Make sure you don't break anything accidentally and also write some tests for your fix/feature.

Issues

Please report any issues on GitHub issues.

Dependencies

  • Tornado (tested with 2.3 and 2.4)

Optional dependencies:

  • Mako (if you want to use Mako templates instead of built-in tornado.template)
  • SQL Alchemy (only if using torneira.models)

On Python 2.5 we also need simplejson module.

Something went wrong with that request. Please try again.