Version 4.2.0

Added

• new 'end_id' parameter for diff processing functions
• new end ID/date parameters for pyosmium tools

Fixed

• restore packaging of README
• use replace() instead of rename() to make overwriting planet files on Windows

Changed

• pre-generate man pages for easier packaging
• diff processing functions and tools now throw an Error when diffs are requested that are older than then oldest available diff on the server
• tools now error out, when the first diff download encounters a client error (HTTP 4xx)

Version 4.1.1

Fixed

• build command for man pages adapted to new structure (thanks @sebastic)

Version 4.1.0

The build process for pyosmium changes slightly with this release. If you are installing via pip, things keep working as before. When installing from source be aware of the following: pybind11 is not longer packaged but will be installed as part of the build from the pypi packages. If you were using on of the *_PREFIX variables to set a custom location for libosmium, protozero or boost, you need to switch to the CMake standard way for custom locations, namly Libosmium_ROOT, Protozero_ROOT or Boost_ROOT. Compiled libraries will no longer be put into the build directory. See README for how to build and run tests during development.

Added

• introduced flake8 linting for Python sources and tests
• experimental support for free-threaded Python
• support for Python 3.14
• binary wheels for Windows ARM architecture

Fixed

• various errors in the documentation (thanks @ltog, @amandasaurus, @uniform641)
• make timestamp conversions thread-safe

Changed

• updated to pybind11 3.0 (drops support for Python 3.7 and CMake < 3.15)
• replace setuptools build system with scikit-build-core
• create version.h on the fly during build
  (now reflects the library versions actually used for building pyosmium)
• example code modernized (thanks @jake-low)

Version 4.0.2

Fixed

• set proper default 'osc.gz' for prefixes on replication servers

Added

• add documentation for writing custom objects and replication module

Version 4.0.1

Fixed

• correctly package py.typed file
• typing: correctly report inheritance of SimpleWriter and NodeLocationsForWays

Version 4.0.0

This release introduces iterative processing of OSM files. It also adds filtering of irrelevant data to speed up processing, so that pyosmium may now be used even with planet-sized files. Have a look at the completely overhauled user manual to learn about the new features.

Added

• support for Python 3.13
• iterative processing of OSM files (see FileProcessor)
• new flush() callback for handlers
• FileBuffer for reading from a Python buffer instead of a file
• bit operators for entity bit enum
• filter mode for handlers (return False to stop processing)
• various C++-implementations of filters (for tags, keys, ids, etc.)
• convenience functions to determine object types
• binary wheels for MAcOS and Intel ARM architecture
• haversine functions for two point
• direct access to lat/lon for nodes
• expose osmium's IdSet
• new IdTracker for efficient tracking of dependent objects
• new writers for adding forward and backward references to output
• new parameter for server file type for pyosmium_get_updates
• new filter to add __geo_interface__ attribute

Fixed

• consistently use namespaces everywhere
• deprecation warnings around utc_now (thanks @mtmail)

Changed

• SimpleHandler is now a Python class
• make NodeLocationForWays a generic BaseHandler
• apply() and MergeInputReader can take an arbitrary number of handlers
• accept Python class as handler, no inheritance from SimpleHandler necessary
• new minimum requirements: pybind 2.7, Python 3.7, C++17 compatible compiler, cmake 3.8
• AreaManager is now part of the Python interface
• consistently allow str, Path, File and FileBuffer, where OSM files are expected
• objects stay alive through handler chain allowing to carry over extra attributes
• switch SimpleWriter to use keyword arguments
• make Reader and SimpleWriter context managers
• new overwrite parameter for writers
• remove GIL release, only slows down processing
• move documentation of C++ interface into pyi files
• complete rewrite of documentation using mkdocs
• update pybind to 2.13.6
• use maximum parallelization when building (thanks @Mathiasdm)
• move build configuration to pyproject.toml as far as possible

Version 3.7.0

Added

• transparently retry download on transient HTTP errors

Fixed

• catch non-200 status for HTTP responses

Changed

• switch unit tests for replication to use pytest-httpserver
• update to pybind 2.11.1
• update to libosmium 2.20.0

This is the last version to support overwriting ReplicationServer.open_url(). Use new ReplicationServer.set_request_parameter() function instead.

Version 3.6.0

This release brings a major rewrite of the libosmium wrapper code. Access to libosmium objects and functions now goes through thin proxy objects which make sure that the underlying data buffers are still accessible. This replaces the check for reference counters which has caused a lot of cryptic errors. Users are still not allowed to keep references to data received in the handler callbacks. However, this will only be checked when data is accessed. Just keeping a reference around will not raise exceptions anymore. str() and repr() are guaranteed to never throw, even when the reference is invalid. That should make it easier to debug your code. These changes are all internal. The user-facing library interface and behaviour hasn't changed. Your code should just work with this new version.

Added

• new example for creating geojson from a OSM file

Changed

• complete internal rewrite of the bindings for OSM data types
• invalid buffers are now checked on access time, no more reference count checks on leaving the handler callback
• update to pybind 2.10.3
• update to libosmium 2.19.0
• change minimum required version of Cmake to 3.0

Version 3.5.0

Added

• type annotations for the public interface
• new ReplicationServer.set_request_parameter() function to specify additional parameters to give to requests.get()

Fixed

• writer now rolls back data buffer after exceptions (fixes #212)
• off-by-one error in computation of change ID from a start date
• socket timeout in pyosmium-get-changes/pyosmium-up-to-date was ignored falling back to waiting forever on requests

Changed

• use format strings instead of format() where possible
• pyosmium-get-changes now prints an error message when there is a HTTP error
  during download
• overwriting ReplicationServer.open_url() is no longer recommended, use new ReplicationServer.set_request_parameter() function instead
• cookies for pyosmium-get-changes/pyosmium-up-to-date are now set via request parameters, removing the last use-case where urllib was used
• update bundled pybind11 to 2.10.1

Version 3.4.1

Fixed

• allow building docs from built sources in PYTHONPATH again