Metadata-Version: 1.0
Name: mbutil
Version: 0.1.1
Summary: An importer and exporter for MBTiles
Home-page: https://github.com/mapbox/mbutil
Author: Tom MacWright
Author-email: tom@macwright.org
License: LICENSE.md
Description: # MBUtil
        
        MBUtil is a utility for importing and exporting the [MBTiles](http://mbtiles.org/) format,
        typically created with [MapBox](http://mapbox.com/) [TileMill](http://mapbox.com/tilemill/).
        
        Before exporting tiles to disk, see if there's a [MapBox Hosting plan](http://mapbox.com/plans/)
        or an open source [MBTiles server implementation](https://github.com/mapbox/mbtiles-spec/wiki/Implementations)
        that works for you - tiles on disk are notoriously difficult to manage.
        
        ## Installation
        
        Git checkout (requires git)
        
            git clone git://github.com/mapbox/mbutil.git
            cd mbutil
            ./mb-util -h
        
            # then to install the mb-util command globally:
            sudo python setup.py install
            # then you can run:
            mb-util
        
        Python installation (requires easy_install)
        
            easy_install mbutil
            mb-util -h
        
        ## Usage
        
        Export an `mbtiles` file to files on the filesystem:
        
            mb-util World_Light.mbtiles adirectory
        
        Import a directory into a `mbtiles` file
        
            mb-util directory World_Light.mbtiles
        
        ## Requirements
        
        * Python `>= 2.6`
        
        ## Metadata
        
        MBUtil imports and exports metadata as JSON, in the root of the tile directory, as a file named `metadata.json`.
        
        ```javascript
        {
            "name": "World Light",
            "description": "A Test Metadata",
            "version": "3"
        }
        ```
        
        ## Testing
        
        This project uses [nosetests](http://readthedocs.org/docs/nose/en/latest/) for testing. Install nosetests
        and run
        
            nosetests
        
        ## See Also
        
        * [node-mbtiles provides mbpipe](https://github.com/mapbox/node-mbtiles/wiki/Post-processing-MBTiles-with-MBPipe), a useful utility.
        
        ## License
        
        BSD - see LICENSE.md
        
        ## Authors
        
        - Tom MacWright (tmcw)
        - Dane Springmeyer (springmeyer)
        - Mathieu Leplatre (leplatrem)
        
Platform: UNKNOWN
