web2py

web2py Enterprise Web Framework

web2py logo
Original author(s)	Massimo Di Pierro
Initial release	September 27, 2007; 16 years ago (2007-09-27)
Stable release	2.27.1[1]  / 16 November 2023; 4 months ago (16 November 2023)
GNU Lesser General Public License version 3 (LGPLv3)
Website	www.web2py.com

This article may contain excessive or inappropriate references to self-published sources. Please help improve it by removing references to unreliable sources where they are used inappropriately. (April 2024) (Learn how and when to remove this template message)

Web2py is an

Web2py is a full-stack framework in that it has built-in components for all major functions, including:

• cookies, sessions
  ;
• multiple protocols
  Flex), and SOAP;^[4]
• CRUD API;
• multiple authentication mechanisms and role-based access control;
• database abstraction layer (DAL) that dynamically generates SQL and runs on multiple compatible database backends;
• RAM, disk, and memcached-based caching for scalability;
• internationalization
  support;
• jQuery for Ajax and UI effects;
• automatic logging of errors with context.

Web2py encourages sound software engineering practices such as

• the model–view–controller (MVC) pattern;
• self-submission
  web forms
  ;
• server-side
  sessions;
• safe handling of uploaded files.

Web2py uses the

All development, debugging, testing, maintenance and remote database administration can (optionally) be performed without third-party tools, via a web interface, itself a web2py application. Internationalization (adding languages and writing translations) can also be performed from this IDE. Each application has an automatically generated database administrative interface, similar to Django. The web IDE also includes web-based testing.

Applications can also be created from the

• Wing IDE allows graphical debugging of web2py applications^[9] as you interact with it from your web browser, you can inspect and modify variables, make function calls etc.
• Eclipse/PyDev — Eclipse with the Aptana PyDev plugin — supports web2py as well.^[10][11]
• The extensible pdb debugger is a module of Python's standard library.
• With the platform-independent open-source Winpdb debugger, one can perform remote debugging
  TCP/IP, through encrypted connection.^[13]

The Hello World program with web2py in its simplest form (simple web page^[14] with no template) looks like:

def hello():
    return 'Hello World'

Web2py includes pure Python-based

Web2py also includes two markup libraries: the markdown2 text-to-HTML filter, which converts Markdown markup to HTML on the fly; and markmin which is inspired by markdown but supports tables, html5 video/audio and oembed protocol.

A controller without a view automatically uses a generic view that render the variables returned by the controller, enabling the development of an application's business logic before writing HTML. The "Hello World" example using a default template:

def hello():
    return dict(greeting='Hello World')

The dict() output of an action is automatically rendered in HTML if the page is request with a .html extension, in JSON if the page is requested with a .json extension, in XML if requested with .xml. It supports other protocols including jsonp, rss, ics, google maps, etc. and is extensible.

Here is a more complex code example which defines a table, and exposes a grid to logged in users:

db.define_table('thing',Field('name',notnull=True))

@auth.requires_login()
def hello():
    return dict(grid = SQLFORM.grid(db.thing))

Ticketing system

Each web2py application comes with a ticketing system:

• If an error occurs, it is logged and a ticket is issued to the user. That allows error tracking.
• Errors and source code are accessible only to the administrator, who can search and retrieve errors by date or client-IP. No error can result in code being exposed to the users.

Portable cron

Cron is a mechanism for creating and running recurrent tasks in background. It looks for an application-specific

• Soft cron: cron routines are checked after web page content has been served, does not guarantee execution precision. For unprivileged Apache CGI/WSGI installs.
• Hard cron: a cron
  thread
  gets started on web2py startup. For Windows and Rocket/standalone web2py installs.
• System cron: cron functions get force-called from the
  command line
  , usually from the system crontab. For Unix/Linux systems and places where the cron triggers need to be executed even if web2py is not running at the moment; also good for CGI/WSGI installs if you have access to the system crontab.

Scheduler

Since version 2.3 the use of cron is discouraged since web2py comes with a master/worker scheduler. Jobs can be defined in models and are scheduled by creating an entry in the database. Users can start work processes who pickup and execute tasks in background. The schedule is better than cron because it allows to specify more parameters (start time, stop time, number of repetitions, number of trials in case of error) and do a better job at running within constant resource utilization.

Bytecode distribution

Web2py can compile web applications for distribution in bytecode compiled form, without source code. Unlike frameworks that use specialized template languages for their views, Web2py can also compile the view code into bytecode, since it is pure Python code.

Global Environment

This article needs additional citations for verification. Please help improve this article by adding citations to reliable sources. Unsourced material may be challenged and removed. Find sources: "Web2py" – news · newspapers · books · scholar · JSTOR (November 2013) (Learn how and when to remove this template message)

Web2py is unique in the world of Python web frameworks because models and controllers are executed, not imported. They are not modules. They are executed in a single global environment which is initialized at each HTTP request. This design decision has pros and cons.

The major pro is the ease of development, specifically for rapid prototyping. Another pro is that all the objects defined within this environment are cleanly reset at each HTTP request and never shared across requests. This means the developer does not need to worry about changing the state of an object (for example the readable attribute of a database field) or worry about a change leaking to other concurrent requests or other applications. A third advantage is that web2py allows the coexistence of multiple applications under the same instance without conflicts even if they use different versions of the same modules or different modules with the same name.

The main disadvantage of the global environment is that model files and controller files are not modules and the order of execution matters (although it can be specified using conditional models). Naming conflict is more likely to occur than in normal Python modules. Some standard Python development tools may not understand objects defined in models and controllers. Moreover, developers must be aware that code in models is executed at every request and this may cause a performance penalty. Nothing in web2py prevents developers from using and importing normal Python modules (model-less approach) and for this purpose web2py provides a thread local object (current) to facilitate access to objects associated to the current request. Yet, in this case, the developer has to be aware of the same pitfalls that other frameworks incur: changing the state of an object defined in a module may affect other concurrent requests.

Another con is that, because models and controllers are not class-based, efficient code reuse becomes more difficult, particularly as the inability to inherit from a parent controller (e.g. the ApplicationController in Ruby on Rails) means that common controller functionality must be referenced repeatedly across all controller files.

Supported environments

Operating systems, Python versions & implementations, virtual machines, hardware

web2py runs on

web2py since v1.64.0 runs unmodified on Java with Jython 2.5, without any known limitation.^[17]

web2py code can run with IronPython on .NET.^[18] Limitations:

• no csv module (so no database I/O);
• no third party database drivers (not even SQLite, so no databases at all);
• no built-in web server (unless you cripple it by removing signals and logging).

The web2py binary will^[19] run from a USB drive or a portable hard drive without dependencies, like Portable Python.

Web servers

Web2py can service requests via

• Aptana Studio with integrated PyDev
• Eclipse with PyDev
• Eric with built-in debugger.^[27]
• Wing IDE^[28]
• Microsoft Visual Studio with Python Tools for Visual Studio
• Pycharm3 has Web2py framework support

Database handling

The database abstraction layer (DAL) of web2py dynamically and transparently generates SQL queries and runs on multiple compatible database backend without the need for database-specific SQL commands (though SQL commands can be issued explicitly).

SQLite is included in Python and is the default web2py database. A connection string change allows connection to Firebird, IBM Db2, Informix, Ingres, Microsoft SQL Server, MySQL, Oracle, PostgreSQL, and Google App Engine (GAE) with some caveats. Specialities:

• Multiple database connections.
• Automatic table creates and alters.
• Automatic transactions.
• Distributed transactions:
  • Since web2py v1.17 with PostgreSQL v8.2 and later,^[29][30] because it provides API for two-phase commits.
  • Since web2py v1.70.1 with Firebird and MySQL (experimental).
• GAE is not a relational store, but web2py emulates certain operations.

The DAL is fast, at least comparable with SQLAlchemy and Storm.^[31]

Web2py implements a DAL, not an

db = DAL('postgresql://user:pass@localhost/db', pool_size=10)
db.define_table('person',Field('name'),Field('image','upload'))
db.person.insert(name='Martin', image=open('filename.png'))
rows = db((db.person.name=='Martin')|db.person.name.contains('T')).select(orderby=db.person.name.lower())

web2py supports database migrations—change the definition of a table and web2py ALTERs the table accordingly. Migrations are automatic, but can be disabled for any table, and migration is typically disabled when an application is ready for live distribution. Migrations and migration attempts are logged, documenting the changes.

Limitations:

• SQLite cannot alter table and change a column type, but rather simply stores new values according to the new type.
• GAE has no concept of alter-table, so migrations are limited.

Licenses

Web2py code is released under

Web2py code before version 1.91.1 was released under GNU GPL v2.0 with commercial exception.

Various third-party packages distributed with web2py have their own licenses, generally

Web2py is copyrighted by Massimo DiPierro. The web2py trademark is owned by Massimo DiPierro.

Awards

In 2011 InfoWorld ranked web2py highest among the top six Python web frameworks, awarded web2py the Bossie award 2011 for best open source application development software. In 2012 web2py won the InfoWorld Technology of the Year award.^[34][35]

Publications

web2py Book

The base web2py documentation is The Official web2py Book, by Massimo DiPierro. The manual is a full web2py application and it's freely available online,^[36] in PDF format or printed form.

• 1st Edition:
  ISBN 978-0-470-43232-7
  .
• 2nd Edition: web2py Manual. Wiley; August 26, 2009; 341 pages;
  ISBN 978-0-470-59235-9
  .
• 3rd Edition: Lulu; September 25, 2010 357 pages.
• 4th Edition: Lulu; December 9, 2011 583 pages.
• 5th Edition: PDF Copy; March 3, 2013 614 pages;
  ISBN 978-0-578-12021-8
  .
• latest online sources: on GitHub[37]

Online documentation

Online documentation is linked from the web2py home page, with cookbook, videos, interactive examples, interactive API reference, epydoc s (complete library reference), FAQ, cheat sheet, online tools etc.

• Cheat sheet for web2py.
• web2pyslices, recipes posted using the movuca social network in web2py.
• Crash Course in Web2py (5-part series).
• Web2py slides (old).

Videos

• web2py Enterprise Web Framework Tutorial.
• web2py "Shootout" video tutorial.
• web2py on the Google appengine.
• web2py: Create, edit, and deploy a basic web app.

Printed

• "web2py application development cookbook", Packt, 2012
• Web programming with web2py; Python Magazine; Marco Tabini & Associates, Inc.; June 2008

Background

Developers

The lead developer of web2py is Massimo DiPierro, an associate professor of

• Git on GitHub
  : Web2Py

• Python-based components:
  • Rocket, a fast,
    multi-threaded, SSL-enabled and streaming-capable WSGI
    server;
  • fcgi.py: a FastCGI/WSGI gateway;
  • Login API for Janrain, Dropbox, Google, LDAP, PAM, X509, CAS, OpenID, OAuth 1&2, Loginza
  • simplejson: a simple, fast, complete, correct and extensible JSON encoder and decoder;
  • markdown2: a Markdown processor;
  • fpdf a library for PDF generation;
  • PyRTF: an RTF document generator;
  • a
    syntax highlighter
    ;
  • pysimplesoap for SOAP services;
  • PyRSS2Gen: an RSS generator;
  • feedparser: to parse RSS and
    Atom
    feeds.
• JavaScript-based components:
  • jQuery: a lightweight JavaScript library;
  • CodeMirror: a free editor for source code;
• C-based components:
  • SQLite: a relational database;
  • memcached: a general-purpose distributed memory caching system.
  • Payment API for Authorize.Net, Google Wallet, Stripe.com

History and naming

The source code for the first public version of web2py was released under GNU GPL v2.0 on 2007-09-27 by Massimo DiPierro as the Enterprise Web Framework (EWF). The name was changed twice due to name conflicts: EWF v1.7 was followed by Gluon v1.0, and Gluon v1.15 was followed by web2py v1.16. The license was changed to LGPLv3 as of web2py version 1.91.1 on 2010-12-21.

Applications built on Web2py

• Movuca CMS and Social Network Engine.
• Instant Press Blog platform.
• Ourway Social networking site.
• NoobMusic A rock music website.
• LinkFindr Network diagnostic tool.
• StarMaker Develops karaoke-style social music apps.

Notes

External links

• Official website