mappyfile

A pure Python parser for working with MapServer MapFiles, built using Lark

An online formatter demonstrating the libraries capabilities can be found at: http://mappyfile.geographika.net/

A presentation on mappyfile was given at FOSS4G Europe 2017 - slides are available for download here.

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

Requirements

Python 2.7 or Python 3.x

Installation

mappyfile is available on PyPI (Python Package Index), and can be installed using pip:

pip install mappyfile

This will also install its required dependences Lark (lark-parser), and jsonschema.

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

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

mappyfile format raster.map formatted_raster.map
mappyfile validate D:\ms-ogc-workshop\ms4w\apps\ms-ogc-workshop\**\*.map
mappyfile schema mapfile-schema-7-6.json --version=7.6

Authors

Seth Girvin @geographika
Erez Shinan @erezsh

Contributors

Julien Enselme @jenselme
Loïc Gasser @loicgasser
Ian Turton @ianturton
@thorag76

Metadata

Release files for mappyfile 0.9.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mappyfile 0.9.4
File	Size	Uploaded
mappyfile-0.9.4.tar.gz	93.6 kB	Feb 22, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for mappyfile 0.9.4
File	Interpreter	ABI	Platform	Reset
mappyfile-0.9.4-py2.py3-none-any.whl 54.1 kB Feb 22, 2022	Python 2, Python 3	none	any	Details

Total release size: 147.7 kB

Release files / mappyfile-0.9.4.tar.gz

Download URL	mappyfile-0.9.4.tar.gz
Size	93.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`753e01e3bc1343906a5009a504a2ddb60745cadb555e3beab4286ce3f841c6f0`
BLAKE2b-256 checksum How to use checksums	`c12fbec6503320b2e26e97a5e339ec6eeedd0da2fa2bbbe631954f3cb46a6423`
Upload date	Feb 22, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.15.0 pkginfo/1.8.2 requests/2.27.1 setuptools/44.1.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/2.7.17`

Release files / mappyfile-0.9.4-py2.py3-none-any.whl

Download URL	mappyfile-0.9.4-py2.py3-none-any.whl
Size	54.1 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`683af8ceba57a41b39be43342c98f32f49e2f11b1edf9093b9a2a37ce760e0e8`
BLAKE2b-256 checksum How to use checksums	`b228437ca795bc6ab04f50b4ccef2ab1306b575bfd55348a75231a28302fd573`
Upload date	Feb 22, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.15.0 pkginfo/1.8.2 requests/2.27.1 setuptools/44.1.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/2.7.17`