TileStache (version N.N.N)
index

A stylish alternative for caching your map tiles.
 
TileStache is a Python-based server application that can serve up map tiles
based on rendered geographic data. You might be familiar with TileCache
(http://tilecache.org), the venerable open source WMS server from MetaCarta.
TileStache is similar, but we hope simpler and better-suited to the needs of
designers and cartographers.
 
Documentation available at http://tilestache.org/doc/

 
Package Contents
       
Caches
Config
Core
Geography
Goodies (package)
MBTiles
Memcache
Pixels
Providers
S3
Vector (package)

 
Classes
       
WSGITileServer

 
class WSGITileServer
    Create a WSGI application that can handle requests from any server that talks WSGI.
 
The WSGI application is an instance of this class. Example:
 
  app = WSGITileServer('/path/to/tilestache.cfg')
  werkzeug.serving.run_simple('localhost', 8080, app)
 
  Methods defined here:
__call__(self, environ, start_response)
__init__(self, config, autoreload=False)
Initialize a callable WSGI instance.
 
Config parameter can be a file path string for a JSON configuration
file or a configuration object with 'cache', 'layers', and
'dirpath' properties.
 
Optional autoreload boolean parameter causes config to be re-read
on each request, applicable only when config is a JSON file.

 
Functions
       
cgiHandler(environ, config='./tilestache.cfg', debug=False)
Read environment PATH_INFO, load up configuration, talk to stdout by CGI.
 
Calls requestHandler().
 
Config parameter can be a file path string for a JSON configuration file
or a configuration object with 'cache', 'layers', and 'dirpath' properties.
getPreview(layer)
Get a type string and dynamic map viewer HTML for a given layer.
getTile(layer, coord, extension, ignore_cached=False)
Get a type string and tile binary for a given request layer tile.
 
Arguments:
- layer: instance of Core.Layer to render.
- coord: one ModestMaps.Core.Coordinate corresponding to a single tile.
- extension: filename extension to choose response type, e.g. "png" or "jpg".
- ignore_cached: always re-render the tile, whether it's in the cache or not.
 
This is the main entry point, after site configuration has been loaded
and individual tiles need to be rendered.
getcwd(...)
getcwd() -> path
 
Return a string representing the current working directory.
mergePathInfo(layer, coord, extension)
Converts layer name, coordinate and extension back to a PATH_INFO string.
 
See also splitPathInfo().
modpythonHandler(request)
Handle a mod_python request.
 
Calls requestHandler().
 
Example Apache configuration for TileStache:
 
<Directory /home/migurski/public_html/TileStache>
    AddHandler mod_python .py
    PythonHandler TileStache::modpythonHandler
    PythonOption config /etc/tilestache.cfg
</Directory>
 
Configuration options, using PythonOption directive:
- config: path to configuration file, defaults to "tilestache.cfg",
    using request.filename as the current working directory.
parseConfigfile(configpath)
Parse a configuration file and return a Configuration object.
 
Configuration file is formatted as JSON with two sections, "cache" and "layers":
 
  {
    "cache": { ... },
    "layers": {
      "layer-1": { ... },
      "layer-2": { ... },
      ...
    }
  }
 
The full path to the file is significant, used to
resolve any relative paths found in the configuration.
 
See the Caches module for more information on the "caches" section,
and the Core and Providers modules for more information on the
"layers" section.
requestHandler(config_hint, path_info, query_string)
Generate a mime-type and response body for a given request.
 
Requires a configuration and PATH_INFO (e.g. "/example/0/0/0.png").
 
Config_hint parameter can be a path string for a JSON configuration file
or a configuration object with 'cache', 'layers', and 'dirpath' properties.
 
Query string is optional, currently used for JSON callbacks.
 
Calls getTile() to render actual tiles, and getPreview() to render preview.html.
requestLayer(config, path_info)
Return a Layer.
 
Requires a configuration and PATH_INFO (e.g. "/example/0/0/0.png").
 
Config parameter can be a file path string for a JSON configuration file
or a configuration object with 'cache', 'layers', and 'dirpath' properties.
splitPathInfo(pathinfo)
Converts a PATH_INFO string to layer name, coordinate, and extension parts.
 
Example: "/layer/0/0/0.png", leading "/" optional.
time(...)
time() -> floating point number
 
Return the current time in seconds since the Epoch.
Fractions of a second may be present if the system clock provides them.

 
Data
        __version__ = 'N.N.N'
stdout = <open file '<stdout>', mode 'w' at 0x1004160b8>