.. comment: Pubsub documentation master file, created by
            sphinx-quickstart on Mon Jun 30 10:00:16 2008.
.. comment: generated with "sphinx-build -a . _build"

Pubsub Home page
================

The Python Pubsub package provides a publish - subscribe API that allows data to 
be sent between independent parts of your application. For instance, between the 
GUI components and the Application Controller. Using publish - subscribe in your 
application can dramatically simplify its design and improve testability. I liked 
the following summary by the creator of wxPython: 

	Basically you just have some part(s) of your program 
	subscribe to a particular topic and have some other part(s) 
	of your program publish messages with that topic.  All the 
	plumbing is taken care of by pubsub.  -- *Robin Dunn, Jun 2007*

Schematically:

.. image:: apidocs/pubsub_concept.png
   :alt: Sketch showing how pubsub fits into a Python application
   :align: center

Using publish - subscribe in an application can sometimes
dramatically simplify its design and improve testability. This is 
explained further in the :ref:`label-usage` section.

Indices and tables
-------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`


Contents
----------

.. This should be hidden but a bug in Sphinx prevents it

.. toctree::
   :maxdepth: 3

   self
   about
   installation
   apidocs/index
   recipes/index