mappyfile 1.2.0

A pure Python MapFile parser for working with MapServer

A pure Python parser for working with MapServer MapFiles, built using Lark. mappyfile is an official OSGeo Community Project.

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 (the Python Package Index), and can be installed using pip:

pip install mappyfile

This will also install its required dependencies - Lark, and jsonschema.

To install the optional lark-cython library for better performance on CPython you can run the following command:

pip install mappyfile[lark_cython]

pip install mappyfile[lark_cython,yaml]

mappyfile is also available on conda. Install as follows:

conda install -c conda-forge mappyfile

Documentation

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

Usage

From within Python scripts:

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"))

YAML support is available as an optional extra (pip install mappyfile[yaml]):

import mappyfile
import mappyfile.yaml

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

# export to YAML
mappyfile.yaml.save(mapfile, "raster.yaml")

# load back from YAML
mapfile2 = mappyfile.yaml.open("raster.yaml")
print(mappyfile.dumps(mapfile2))

Command line tools are also available - format, validate, schema, yaml-export, and yaml-import:

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
mappyfile yaml-export raster.map raster.yaml
mappyfile yaml-import raster.yaml raster.map

Authors

• Seth Girvin @geographika

• Erez Shinan @erezsh

Contributors

• Julien Enselme @jenselme

• Loïc Gasser @loicgasser

• Ian Turton @ianturton

• @thorag76

• @DonQueso89

• TC Haddad @tchaddad (Conda support)