Getting Started with Pylons¶

• Getting Started
  • Requirements
  • Installing
  • Creating a Pylons Project
  • Running the application
  • Hello World

• Concepts of Pylons
  • The ‘Why’ of a Pylons Project
  • WSGI Applications
  • WSGI Middleware
  • Controller Dispatch
  • Paster
  • Loading the Application

Tutorials¶

• Pylons Tutorials
  • Quickwiki tutorial
  • Understanding Unicode

MVC Reference¶

• Controllers
  • Standard Controllers
  • Using the WSGI Controller to provide a WSGI service
  • Using the REST Controller with a RESTful API
  • Using the XML-RPC Controller for XML-RPC requests

• Views
  • Templates
  • Passing Variables to Templates
  • Default Template Variables
  • Configuring Template Engines
  • Custom render() functions
  • Templating with Mako

• Models
  • About the model
  • Model basics
  • Working with SQLAlchemy

Project Configuration and Logging¶

• Configuration
  • Runtime Configuration
  • Environment
  • URL Configuration
  • Middleware
  • Application Setup

• Logging
  • Logging messages
  • Basic Logging configuration
  • Filtering log messages
  • Advanced Configuration
  • Request logging with Paste’s TransLogger
  • Logging to wsgi.errors

Forms, Validation, and Helpers¶

• Helpers
  • Pagination
  • Secure Form Tag Helpers

• Forms
  • The basics
  • Getting Started
  • Using the Helpers
  • File Uploads
  • Validating user input with FormEncode
  • Other Form Tools

Internationalization, Sessions, and Caching¶

• Internationalization and Localization
  • Introduction
  • Getting Started
  • Using Babel
  • Back To Work
  • Testing the Application
  • Fallback Languages
  • Translations Within Templates
  • Lazy Translations
  • Producing a Python Egg
  • Plural Forms
  • Summary
  • Further Reading
  • babel.core – Babel core classes
  • babel.localedata — Babel locale data
  • babel.dates – Babel date classes
  • babel.numbers – Babel number classes

• Sessions
  • Sessions
  • Session Objects
  • Beaker
  • Custom and caching middleware
  • Bulk deletion of expired db-held sessions
  • Using Session in Internationalization
  • Using Session in Secure Forms
  • Hacking the session for no cookies
  • Using middleware (Beaker) with a composite app
  • storing SA mapped objects in Beaker sessions

• Caching
  • Using the Cache object
  • Using Cache keywords to render
  • Using the Cache Decorator
  • Caching Arbitrary Functions
  • ETag Caching
  • Inside the Beaker Cache

Testing, Upgrading, and Deploying¶

• Unit and functional testing
  • Unit Testing with webtest
  • Example: Testing a Controller
  • Testing Pylons Objects
  • Testing Your Own Objects
  • Unit Testing
  • Functional Testing

• Troubleshooting & Debugging
  • Interactive debugging
  • The Debugging Screen
  • Example: Exploring the Traceback
  • Email Options

• Upgrading
  • Upgrading from 0.9.6 -> 0.9.7
  • Moving from a pre-0.9.6 to 0.9.6

• Packaging and Deployment Overview
  • Egg Files
  • Installing as a Non-root User
  • Understanding the Setup Process
  • Deploying the Application
  • Advanced Usage
• Running Pylons Apps with Other Web Servers
  • Using Fast-CGI
  • Apache Configuration
  • PrefixMiddleware
  • Using Java Web Servers with Jython
• Documenting Your Application
  • Introduction
  • Tutorial
  • Learning ReStructuredText
  • Using Docstrings
  • Using doctest
  • Summary
• Distributing Your Application
  • Running Your Application

Installation for Windows / Python 2.3¶

• Python 2.3 Installation Instructions
  • Advice of end of support for Python 2.3
  • Preparation
  • System-wide Install

• Windows Notes
  • For Win2K or WinXP
  • For Windows 95, 98 and ME
  • Finally

Pylons on Jython¶

• Pylons on Jython
  • Installation
  • Deploying to Java Web servers

Advanced Pylons¶

• Security policy for bugs
  • Receiving Security Updates
  • Reporting Security Issues
  • Minimising Risk

• WSGI support
  • Paste and WSGI
  • Using a WSGI Application as a Pylons 0.9 Controller
  • Running a WSGI Application From Within a Controller
  • Configuring Middleware Within a Pylons Application
  • The Cascade
  • Useful Resources

• Advanced Pylons
  • WSGI, CLI scripts
  • Adding commands to Paster
  • Creating Paste templates
  • Using Entry Points to Write Plugins

Module Listing¶

• Pylons Modules
  • pylons.commands – Command line functions
  • pylons.configuration – Configuration object and defaults setup
  • pylons.controllers – Controllers
  • pylons.controllers.core – WSGIController Class
  • pylons.controllers.util – Controller Utility functions
  • pylons.controllers.xmlrpc – XMLRPCController Class
  • pylons.decorators – Decorators
  • pylons.decorators.cache – Cache Decorators
  • pylons.decorators.rest – REST-ful Decorators
  • pylons.decorators.secure – Secure Decorators
  • pylons.error – Error handling support
  • pylons.i18n.translation – Translation/Localization functions
  • pylons.log – Logging for WSGI errors
  • pylons.middleware – WSGI Middleware
  • pylons.templating – Render functions and helpers
  • pylons.test – Test related functionality
  • pylons.util – Paste Template and Pylons utility functions
  • pylons.wsgiapp – PylonsWSGI App Creator

• Third-party components
  • beaker – Beaker Caching
  • FormEncode
  • routes – Route and Mapper core classes
  • weberror – Weberror
  • webhelpers – Web Helpers package
  • webtest – WebTest
  • webob – WebOb

• Glossary

For further information, indices are available: