pecan

What it is and what it does

Pecan is a WSGI web framework that maps HTTP requests directly to Python object hierarchies, making URL structure mirror your application's class structure. Instead of defining routes as strings, you organize controller classes and methods that correspond to URL paths. It depends on WebOb for request/response handling and Mako for templating, keeping the dependency footprint small.

The framework is designed for developers who prefer explicit, object-oriented routing over convention-based or decorator-heavy approaches. It has been in production use since 2012 and maintains active development. The project supports modern Python versions and is suitable for building REST APIs, web services, and traditional web applications where you want direct control over URL-to-code mapping.

Use it for:

• Build REST APIs where URL structure naturally maps to resource hierarchies and controller classes.
• Create web services where explicit object dispatch is clearer than string-based routing patterns.
• Develop applications requiring minimal framework overhead and few external dependencies.
• Prototype or migrate from other WSGI frameworks while maintaining object-oriented design.
• Build admin interfaces or internal tools where object hierarchy routing simplifies code organization.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Pecan is a WSGI web framework that routes HTTP requests to Python objects based on URL structure, designed to be lightweight with minimal dependencies.

Yes, if you prefer object-oriented URL routing and want a lightweight WSGI framework with low dependency overhead. The permissive BSD license, active maintenance, and support for current Python versions (3.10–3.13) make it a solid choice. Not recommended if you need a large ecosystem of third-party extensions or prefer convention-over-configuration frameworks like Flask or Django.

Install

pecan on PyPI

pip install pecan

uv add pecan

poetry add pecan

Installing pecan

Before you install

Low install friction with only three runtime dependencies (WebOb, Mako, setuptools). The package is actively maintained with a recent commit on 2026-03-12 and supports current Python versions (3.10 through 3.13).

License in practice

BSD license is permissive, allowing use in commercial and proprietary projects with minimal restrictions beyond attribution.

Quickstart

pip install pecan

from pecan import App, expose

class RootController:
    @expose()
    def index(self):
        return 'Hello, World!'

app = App(RootController())

Requires Python 3.10 or later.

Verify before relying

• Whether Pecan's object-dispatch model is suitable for your routing needs compared to path-based routing frameworks.
• Performance characteristics and scalability limits for production deployments.
• Community size and availability of third-party extensions or middleware.

Package facts

Evidence: pecan-1.8.0-py3-none-any.whl

Keywords: web, framework, wsgi, object-dispatch, http

Tags

More Application Frameworks packages