### Navigation

- index
- modules |
- next |
- previous |
- TurboGears 2.1.5 documentation »
- Search:
- Extended Table of Contents »

# The Gears in Detail

This document describes the internal workings of TurboGears, how the system is constructed, how the pieces fit together, and how to navigate the source-code for the project. Normally you will want to read these pages in order to extend, debug, or change the behaviour of TurboGears, or to start contributing to the project.

You will want to have read:

> - Tutorials which describes how to get started with TurboGears
> - Tips and Recipes which describes how to accomplish particular tasks with TurboGears

before diving into this material.

## What’s New With The Latest Release

- What’s New In TurboGears 2
  - The “Why” Of TurboGears 2
  - New Features Of TurboGears 2:
  - Compatibility
  - Command Changes
  - Project Layout Changes
  - New Imports

## General Project Information

- The Turbogears Way
- A Request’s Flow Through The TurboGears Stack
- Contributing To TurboGears 2
- Using BitBucket’s Mercurial Service with TurboGears
- TurboGears Licenses
- TurboGears And Pylons Working Together
- Documentation Generation Guide
- Setting up the TurboGears Test Environment and Testing

## Libraries and Modules Shipped With TurboGears

- 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
- `tg.decorators` – Decorators
- `tg.flash` – Flash
- FormEncode
  - Core API
  - Validators
  - Validator Modifiers
  - HTML Parsing and Form Filling
- `webhelpers` – helper functions for web applications
  - paginate: a module to help split up lists or results from ORM queries
  - Package Contents
- Third-party components
  - `beaker` – Caching
  - `routes` – Route and Mapper core classes
  - `weberror` – Weberror
  - WebHelpers
  - `webob` – WebOb
  - VirtualEnv