The Pyramid Web Application Development Framework
Here is one of the simplest :app:`Pyramid` applications you can make:
When saved to
helloworld.py, the above application can be run via:
$ easy_install pyramid $ python helloworld.py
When you visit
http://localhost:8080/hello/world in a browser, you will
see the text
See :ref:`firstapp_chapter` for a full explanation of how this application works. Read the :ref:`html_narrative_documentation` to understand how :app:`Pyramid` is designed to scale from simple applications like this to very large web applications.
"What's New" Documents
Narrative documentation in chapter form explaining how to use :app:`Pyramid`.
Reference material includes documentation for every :app:`Pyramid` API.
Detailed Change History
cluegun is a simple pastebin application based on Rocky Burt's ClueBin. It demonstrates form processing, security, and the use of :term:`ZODB` within a :app:`Pyramid` application. Check this application out via:
git clone git://github.com/Pylons/cluegun.git
virginia is a very simple dynamic file rendering application. It is willing to render structured text documents, HTML documents, and images from a filesystem directory. It's also a good example of :term:`traversal`. An earlier version of this application runs the repoze.org website. Check this application out via:
git clone git://github.com/Pylons/virginia.git
shootout is an example "idea
competition" application by Carlos de la Guardia and Lukasz Fidosz. It
demonstrates :term:`URL dispatch`, simple authentication, integration
with SQLAlchemy and
Check this application out of version control via:
git clone git://github.com/Pylons/shootout.git
Older Sample Applications (repoze.bfg)
bfgsite is the software which runs the bfg.repoze.org website. It demonstrates integration with Trac, and includes several mini-applications such as a pastebin and tutorial engine. Check a buildout for this application out of Subversion via:
svn co http://svn.repoze.org/buildouts/bfgsite/ bfgsite_buildout
KARL is a moderately-sized application (roughly 70K lines of Python code) built on top of :mod:`repoze.bfg` and other Repoze software. It is an open source web system for collaboration, organizational intranets, and knowledge management, It provides facilities for wikis, calendars, manuals, searching, tagging, commenting, and file uploads. See the KARL site for download and installation details.
Support and Development
To report bugs, use the issue tracker.
If you've got questions that aren't answered by this documentation, contact the Pylons-devel maillist or join the #pyramid IRC channel.
git clone firstname.lastname@example.org:Pylons/pyramid.git