ringo 0.3.0

A simple web framework with base functionality to build web applications.

Ringo

Ringo is a small Python based high level web application framework build with Pyramid . It provides basic functionality which is often used in modern web applications. See the list of features for more details.

Ringo comes with an application scaffold which can be used as a boilerplate for your application development. See the development part in the documentation for more details on how to build a Ringo based application.

In Ringo based applications Ringo plays the role of a base library which provides basic functionality. In most cases this basic functionality should fit the needs in easy usecases. If it fits not, then it can be extended and configured to your need in an easy way.

Ringo is also a standalone application which is under steady development. This is a benefit if you use Ringo as base for your application. Your application will get bug fixes, new features or improved functionality in most cases by simply updating Ringo to a new version.

License

Ringo is Free Software. It is licensed under the GPL license in version 2 or later. See http://www.gnu.org/licenses/gpl-2.0 for more details on the license.

Features

Ringo provides some basic features which are useful if you build your web application based on Ringo:

• Authentication with email registration and password reminders

• Authorisation with a role based permission System

• Basic CRUD actions

• Layout and validation of forms using the Formbar library

• Support for caching expensive SQL queries

• Regular expression based searching (storeable)

• Sorting

• User Profiles

• Extendible, Configurable

Documentation

Documentation is available on http://pythonhosted.org/ringo/

Getting Started

The fastest way to get an impression of Ringo`s core functionallity is to to the following steps:

• cd <directory containing this file>

• $venv/bin/python setup.py develop

• $venv/bin/initialize_ringo_db development.ini

• $venv/bin/pserve development.ini

0.3.0

• #15: Implement Search

• Enabled search by clicking on the value in colums.

• Added table to save usersettings (DB change!)

• Enable saving search queries in the usersettings.

• Added dogpile.cache dependency because of caching in sqlalchemy.

• Enabled basic caching of SQL queries.

0.2.2

• Some improvement in Layout. Make header more compact to not waste to much space

• Create an empty “forms” dir under views for the basic scaffold. Fixes error on creating the form.xml files when adding a new modul.

• Improved add_<<app>>_modul command. Fixed modul (re) initialisation. It the modul initialisation does not happen on recreating again the database.

• Fix get_path function. Path is now relativ to the application (was relativ to Ringo)

• #10: Add “visible” flag to moduls. Moduls can now be configured in which menu to display the modul. (DB change!)

• Added new field “clazzpath” to the modul. Needed only internal for dynmic imports on permission checks. (DB change!)

• Need formbar in version > 0.1 to be able to render selection fields.

0.2.1

• Improved documentation

• Added a simple request history (needed for #7)

• #1: Error on getting roles while authorisation when user is not logged in

• #2: Put some usefull content on the default index page

• #3: Set application title in the page header

• #4: Add version info page

• #5: Add about page

• #6: Add contact page

• #7: Add dialogs for errors (404, 403)

• #9: Cleanup and structure css

• #17: Hide checkboxes in overviews if bundled actions are not enabled

• #20: Fix layout of flash messages

• #21: Complete german translation

0.2

First more or less version which includes all basic functionallity.

• Added basic scaffold

• Added “add_modul” command to add boilerplate code for new moduls.

0.1

• Basic model initialisation

• Basic page layout

• Added authentification

0.0

• Initial version