:mod:`molly.apps.transport` -- Transport dashboard
==================================================

.. module :: molly.apps.transport

A dashboard page which takes transport related data from the places app and
displays it in a friendlier way

Configuration
-------------

 * train_station: A string in the form 'scheme:value' identifying the entity to
   use as the train station on the page (this is the same form as in
   /places/scheme:value/)
 * nearby: A dictionaries of entity types where values are in the form:
   (entity-type-slug, number to show). The keys form the values of the div ids
   in the rendered remplate.
 * transit_status_provider: A provider which provides statues
 * park_and_rides: if specified, then the park and ride entities are shown on the
   page in the order specified (scheme:value strings)
 * travel_alerts: Whether or not to display travel alerts on this page
 
Sample::

    Application('molly.apps.transport', 'transport', 'Transport',
        train_station = 'crs:OXF',
        nearby = {
            'bus_stops': ('bus-stop', 5),
        },
        park_and_rides = ('osm:W4333225', 'osm:W4329908', 'osm:W34425625',
                          'osm:W24719725', 'osm:W2809915'),
        travel_alerts = True,
        transit_status_provider = 'molly.apps.transport.providers.TubeStatusProvider',
    ),

Providers
---------

``molly.apps.transport.providers.TubeStatusProvider``
"""""""""""""""""""""""""""""""""""""""""""""""""""""

This is a provider which provides the current running Tube line status. It has
no options.

Views
-----

.. todo:: Complete