mappyfile

A pure Python parser for working with MapServer <https://mapserver.org>_ MapFiles, built using Lark <https://github.com/lark-parser/lark>_. mappyfile is an official OSGeo Community Project <https://www.osgeo.org/projects/mappyfile/>.

.. image:: https://raw.githubusercontent.com/geographika/mappyfile/master/docs/images/OSGeo_community_small.png :align: right

mappyfile is used for formatting and validation in https://app.mapserverstudio.net/, and can be tested for free on any of your Mapfiles. If you find mappyfile useful please consider signing up for a professional account at https://mapserverstudio.net/. This will help to fund maintenance and further development of both mappyfile and MapServer.

Requirements

Python 3.8 or higher

Installation

mappyfile is available on PyPI <https://pypi.org/project/mappyfile/>_ (the Python Package Index), and can be installed using pip:

.. code-block:: console

pip install mappyfile

This will also install its required dependencies - Lark <https://github.com/lark-parser/lark>_, and jsonschema <https://github.com/python-jsonschema/jsonschema>.

To install the optional lark-cython <https://github.com/lark-parser/lark_cython>_ library for better performance on CPython you can run the following command:

.. code-block:: console

pip install mappyfile[lark_cython]

mappyfile is also available on conda <https://anaconda.org/conda-forge/mappyfile>_. Install as follows:

.. code-block:: console

conda install -c conda-forge mappyfile

Documentation

Full documentation is available at http://mappyfile.readthedocs.io/en/latest/

.. image:: https://raw.githubusercontent.com/geographika/mappyfile/master/docs/images/class_parsed_small.png

Usage

From within Python scripts:

.. code-block:: python

import mappyfile

mapfile = mappyfile.open("./docs/examples/raster.map")

# update the map name
mapfile["name"] = "MyNewMap"

new_layer_string = """
LAYER
    NAME 'land'
    TYPE POLYGON
    DATA '../data/vector/naturalearth/ne_110m_land'
    CLASS
        STYLE
            COLOR 107 208 107
            OUTLINECOLOR 2 2 2
            WIDTH 1
        END
    END
END
"""

layers = mapfile["layers"]

new_layer = mappyfile.loads(new_layer_string)

layers.insert(0, new_layer) # insert the new layer at any index in the Mapfile

for l in layers:
    print("{} {}".format(l["name"], l["type"]))

print(mappyfile.dumps(mapfile, indent=1, spacer="\t"))

Three command line tools are available - format, validate, and schema:

.. code-block:: bat

mappyfile format raster.map formatted_raster.map
mappyfile validate D:\ms-ogc-workshop\ms4w\apps\ms-ogc-workshop\**\*.map
mappyfile schema mapfile-schema-8-0.json --version=8.0