Skip to content

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.5.0 - 2026-11-07

Added

  • output keyword on render methods: output="rgba" returns the raw pixels, skipping PNG encoding. The default, output="png", returns PNG bytes
  • render_bbox and arender_bbox, which render exactly a bounding box, stretched to the image size, as OGC API Maps and WMS GetMap require
  • mapli.MAX_LAT, the latitude limit of Web Mercator that bounding boxes must stay within
  • restrict_resource_urls(), which limits the URLs that styles may fetch to a list of allowed prefixes, for applications that render styles they do not fully control

Changed

  • RenderPool() now releases the GIL while creating the pool, so other Python threads are no longer blocked while the first pool in a process checks for EGL support
  • Static image renderers are cached per style and pixel ratio, and resized for each render, instead of one per image size. Requests for many different sizes no longer evict renderers and reload their styles

Fixed

  • Registering a style again under an id already in use now replaces it everywhere

0.4.1 - 2026-10-22

Added

  • Releases are published to PyPI
  • License metadata (MIT) in the package

0.4.0 - 2026-10-22

Added

  • Custom URL scheme handlers

Changed

  • RenderError messages now include MapLibre Native's reason for the failure, instead of just "render failed"
  • CI: test steps now time out (10 minutes, or 45 for the Rust tests, which also compile) instead of hanging for GitHub's 6-hour default, and pytest dumps every thread's traceback when a test runs for over 60 seconds (faulthandler_timeout), to help diagnose hangs

0.3.1 - 2026-10-12

Fixed

  • CI: rendering tests failed intermittently on some ARM runners, where Mesa tried an unsupported hardware path under Xvfb. Tests now force Mesa's software renderer (LIBGL_ALWAYS_SOFTWARE=1), and the Rust tests also run under Xvfb

0.3.0 - 2026-10-12 [YANKED]

Tagged but never published: the release CI failed. Use 0.3.1, which has the same changes.

Added

  • RenderPool.render_from_bounds() and RenderPool.arender_from_bounds(), which render static images fitted to a bounding box
  • mapli-core: render static images from a bounding box, fitted to the image size with optional padding, bearing and pitch (Bounds, BoundsToFit). Bounds crossing the antimeridian (west > east) are supported

Changed

  • mapli-core: StaticRequest.camera was replaced by StaticRequest.view, which takes either a Camera or bounds to fit (View)

0.2.2 - 2026-10-12

Changed

  • Lowered the minimum supported Python version to 3.11

0.2.1 - 2026-10-12

Added

  • Prebuilt wheels for ARM64 (aarch64) Linux

0.2.0 - 2026-10-09

Added

  • First release