Pylons ++++++

.. image:: https://secure.travis-ci.org/Pylons/pylons.png?branch=master :alt: Build Status :target: https://secure.travis-ci.org/Pylons/pylons

Pylons is a rapid web application development framework.

.. note::

Pylons has merged with repoze.bfg, and is now in maintenance-only
mode. It's highly recommended that new projects start with the new
merged web framework, `pyramid <http://www.pylonsproject.org/>`_.

Install

Read the online Installation instructions <http://docs.pylonsproject.org/projects/pylons-webframework/en/latest/gettingstarted.html#installing>_.

If you want to install from source you can run the following command:

.. code-block :: bash

$ python setup.py install

This will display a message and download setuptools if the module is not already installed. It will then install Pylons and all its dependencies. You may need root privileges to install setuptools.

Testing

To test the source distribution run the following command:

.. code-block :: bash

$ python setup.py test

This will install additional dependencies needed for the tests. As above, you may need root privileges.

Documentation

Read the complete Pylons web framework documentation <http://docs.pylonsproject.org/projects/pylons-webframework/>_.

Definitive Guide to Pylons <https://thejimmyg.github.io/pylonsbook/>_ is a book about Pylons published by Apress, written by James Gardner, with free HTML rendering.

Generating documentation requires Sphinx:

.. code-block :: bash

$ easy_install Sphinx

Then to build the documentation use the commands:

.. code-block :: bash

$ cd pylons/docs/<lang>
$ make html