theshiftedbit / pytiled_parser

Python Library for parsing Tiled Map Editor maps.

PyTiled Parser

PyTiled Parser is a Python Library for parsing JSON formatted Tiled Map Editor maps and tilesets to be used as maps and levels for 2D top-down (orthogonal, hexogonal, or isometric) or side-scrolling games in a strictly typed fashion.

PyTiled Parser is not tied to any particular graphics library, and can be used with Arcade, Pyglet, Pygame, etc.

• Documentation available at: https://pytiled-parser.readthedocs.io/
• GitHub project at: https://github.com/Beefy-Swain/pytiled_parser
• PiPy: https://pypi.org/project/pytiled-parser/

The Arcade library has supporting code to integrate PyTiled with that 2D libary, and example code showing its use.

Original module by Beefy-Swain. Significant contributions from pvcraven and Cleptomania.

Development

To develop pytiled parser, clone the repo, create a venv using a supported Python version, and activate it. Then install the package as well as all testing dependencies with the command python -m pip install -e ".[tests]".

Testing

Run pytest --cov=pytiled_parser to run the test harness and report coverage.