Installation
============

Install the latest version directly from the Codeberg repository:

.. code-block:: bash

   pip install git+https://codeberg.org/fbxyz/mappyng.git

Optional extras
---------------

.. code-block:: bash

   # XYZ/raster basemap tiles (mercantile, Pillow)
   pip install "mappyng[tile] @ git+https://codeberg.org/fbxyz/mappyng.git"

   # GeoTIFF raster backgrounds (rasterio)
   pip install "mappyng[raster] @ git+https://codeberg.org/fbxyz/mappyng.git"

   # PNG/PDF export (cairosvg)
   pip install "mappyng[export] @ git+https://codeberg.org/fbxyz/mappyng.git"

A PyPI release (``pip install mappyng``) is planned.