Skip to content
This repository
branch: 1.3-branch
Fetching contributors…

Octocat-spinner-32-eaf2f5

Cannot retrieve contributors at this time

file 219 lines (161 sloc) 5.497 kb

The Pyramid Web Application Development Framework

:app:`Pyramid` is a small, fast, down-to-earth Python web application development framework. It is developed as part of the Pylons Project. It is licensed under a BSD-like license.

System Message: ERROR/3 (<string>, line 7); backlink

Unknown interpreted text role "app".

Here is one of the simplest :app:`Pyramid` applications you can make:

System Message: ERROR/3 (<string>, line 12); backlink

Unknown interpreted text role "app".

System Message: ERROR/3 (<string>, line 14)

Unknown directive type "literalinclude".

.. literalinclude:: narr/helloworld.py

After you install :app:`Pyramid` and run this application, when you visit http://localhost:8080/hello/world in a browser, you will see the text Hello, world!

System Message: ERROR/3 (<string>, line 16); backlink

Unknown interpreted text role "app".

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.

System Message: ERROR/3 (<string>, line 20); backlink

Unknown interpreted text role "ref".

System Message: ERROR/3 (<string>, line 20); backlink

Unknown interpreted text role "ref".

System Message: ERROR/3 (<string>, line 20); backlink

Unknown interpreted text role "app".

Front Matter

System Message: ERROR/3 (<string>, line 28)

Unknown directive type "toctree".

.. toctree::
   :maxdepth: 1

   copyright.rst
   conventions.rst

What's New

System Message: ERROR/3 (<string>, line 37)

Unknown directive type "toctree".

.. toctree::
   :maxdepth: 1

   whatsnew-1.3
   whatsnew-1.2
   whatsnew-1.1
   whatsnew-1.0

Narrative documentation

Narrative documentation in chapter form explaining how to use :app:`Pyramid`.

System Message: ERROR/3 (<string>, line 50); backlink

Unknown interpreted text role "app".

System Message: ERROR/3 (<string>, line 53)

Unknown directive type "toctree".

.. toctree::
   :maxdepth: 2

   narr/introduction
   narr/install
   narr/firstapp
   narr/configuration
   narr/project
   narr/startup
   narr/router
   narr/urldispatch
   narr/views
   narr/renderers
   narr/templates
   narr/viewconfig
   narr/assets
   narr/webob
   narr/sessions
   narr/events
   narr/environment
   narr/logging
   narr/paste
   narr/commandline
   narr/i18n
   narr/vhosting
   narr/testing
   narr/resources
   narr/hellotraversal
   narr/muchadoabouttraversal
   narr/traversal
   narr/security
   narr/hybrid
   narr/hooks
   narr/introspector
   narr/extending
   narr/advconfig
   narr/extconfig
   narr/scaffolding
   narr/threadlocals
   narr/zca

Tutorials

Tutorials explaining how to use :app:`Pyramid` to build various types of applications, and how to deploy :app:`Pyramid` applications to various platforms.

System Message: ERROR/3 (<string>, line 97); backlink

Unknown interpreted text role "app".

System Message: ERROR/3 (<string>, line 97); backlink

Unknown interpreted text role "app".

System Message: ERROR/3 (<string>, line 101)

Unknown directive type "toctree".

.. toctree::
   :maxdepth: 2

   tutorials/wiki2/index.rst
   tutorials/wiki/index.rst
   tutorials/bfg/index.rst
   tutorials/modwsgi/index.rst

API Documentation

Documentation for every :app:`Pyramid` API.

System Message: ERROR/3 (<string>, line 112); backlink

Unknown interpreted text role "app".

System Message: ERROR/3 (<string>, line 114)

Unknown directive type "toctree".

.. toctree::
   :maxdepth: 2

   api

Change History

System Message: ERROR/3 (<string>, line 122)

Unknown directive type "toctree".

.. toctree::
   :maxdepth: 1

   changes

Design Documents

System Message: ERROR/3 (<string>, line 130)

Unknown directive type "toctree".

.. toctree::
   :maxdepth: 1

   designdefense

Sample Applications

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:

System Message: ERROR/3 (<string>, line 138); backlink

Unknown interpreted text role "term".

System Message: ERROR/3 (<string>, line 138); backlink

Unknown interpreted text role "app".
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:

System Message: ERROR/3 (<string>, line 148); backlink

Unknown interpreted text role "term".
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 pyramid_simpleform. Check this application out of version control via:

System Message: ERROR/3 (<string>, line 159); backlink

Unknown interpreted text role "term".
git clone git://github.com/Pylons/shootout.git

KARL is a moderately-sized application (roughly 80K lines of Python code) built on top of :app:`Pyramid`. 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.

System Message: ERROR/3 (<string>, line 169); backlink

Unknown interpreted text role "app".

Support and Development

The Pylons Project web site is the main online source of :app:`Pyramid` support and development information.

System Message: ERROR/3 (<string>, line 179); backlink

Unknown interpreted text role "app".

To report bugs, use the issue tracker.

If you've got questions that aren't answered by this documentation, contact the Pylons-discuss maillist or join the #pyramid IRC channel.

Browse and check out tagged and trunk versions of :app:`Pyramid` via the Pyramid GitHub repository. To check out the trunk via git, use this command:

System Message: ERROR/3 (<string>, line 190); backlink

Unknown interpreted text role "app".
git clone git@github.com:Pylons/pyramid.git

To find out how to become a contributor to :app:`Pyramid`, please see the contributor's section of the documentation.

System Message: ERROR/3 (<string>, line 198); backlink

Unknown interpreted text role "app".

Index and Glossary

System Message: ERROR/3 (<string>, line 212)

Unknown directive type "toctree".

.. toctree::
   :hidden:

   glossary
   foreword.rst
   latexindex.rst

Something went wrong with that request. Please try again.