Fixing a few .rst formatting issues.

This commit is contained in:
Ryan Petrello
2012-03-14 22:19:13 -07:00
parent 8b8c166b66
commit 37bc24e7c0
3 changed files with 9 additions and 7 deletions

View File

@@ -1,14 +1,14 @@
.. _databases:
Working with Databases, Transactions, and ORM's
=============
===============================================
Out of the box, Pecan provides no opinionated support for working with databases,
but it's easy to hook into your ORM of choice with minimal effort. This article
details best practices for integrating the popular Python ORM, SQLAlchemy, into
your Pecan project.
``init_model`` and Preparing Your Model
----------------
---------------------------------------
Pecan's default quickstart project includes an empty stub directory for implementing
your model as you see fit::
@@ -96,7 +96,8 @@ Here's what a sample Pecan configuration file with database bindings might look
Session.remove()
Binding Within the Application
----------------
------------------------------
There are several approaches that can be taken to wrap your application's requests with calls
to appropriate model function calls. One approach is WSGI middleware. We also recommend
Pecan :ref:`hooks`. Pecan comes with ``TransactionHook``, a hook which can
@@ -146,7 +147,8 @@ manner:
Also note that there is a useful ``@after_commit`` decorator provided in :ref:`pecan_decorators`.
Splitting Reads and Writes
----------------
--------------------------
Employing the strategy above with ``TransactionHook`` makes it very simple to split database
reads and writes based upon HTTP methods (i.e., GET/HEAD requests are read-only and would potentially
be routed to a read-only database slave, while POST/PUT/DELETE requests require writing, and

View File

@@ -45,7 +45,7 @@ was chosen by Pecan's routing.
``on_error`` is passed a shared state object **and** the original exception.
Attaching Hooks
--------------
---------------
Hooks can be attached in a project-wide manner by specifying a list of hooks
in your project's ``app.py`` file::

View File

@@ -1,7 +1,7 @@
.. _session:
Working with Sessions and User Authentication
=============
=============================================
Out of the box, Pecan provides no opinionated support for managing user sessions,
but it's easy to hook into your session framework of choice with minimal
effort.
@@ -10,7 +10,7 @@ This article details best practices for integrating the popular session
framework, `Beaker <http://beaker.groovie.org>`_, into your Pecan project.
Setting up Session Management
----------------
-----------------------------
There are several approaches that can be taken to set up session management.
One approach is WSGI middleware. Another is Pecan :ref:`hooks`.