📦 Release v2.3.0 This release implements a major architectural overhaul to modernize the core infrastructure, updates the build system, and ensures compatibility with Python 3.12 and Pandas 3.0+. Summary of changes since 2.2.0: 🏗️ Architectural refactoring Reorganized downloader and reader subpackages by modularizing Geofabrik and BBBike providers into discrete internal scripts. Decomposed ios into submodules: _base, _pgsql_osm, and _pbf_importer to improve maintainability. Renamed internal utility and provider files to clearly distinguish the private API. 🚀 Infrastructure & build system Migrated project configuration to pyproject.toml in alignment with modern standards. Updated minimum environment requirements to Python>=3.12. Refined geometry detection logic to ensure compatibility with Pandas 3.0+ and GeoPandas. 🔧 Robustness & safety Replaced assert statements with exception handling to ensure validation remains active in optimized byte-code environments. Implemented default behaviors by setting download=False in BaseReader and associated wrappers to prevent unintended network requests. Upgraded dependency management using a more robust multi-package _check_dependencies() helper. 📖 Documentation & code quality Standardized docstrings for improved Sphinx documentation generation. Resolved package-wide linter warnings, including unused imports (F401) and redundant f-strings (F541). Updated README.md, conf.py, and source reST files to reflect the new modular API structure and fixed unresolved cross-references. 🛠️ Bug fixes & testing Refined logic and performance in readers for PBF, shapefile and various other formats of OSM data files. Synchronized the test suite to match the refactored internal logic.

PyDriosm is an open-source tool that provides an effortless way to download and access OpenStreetMap (OSM) data in popular file formats, such as shapefile and protobuf binary format (PBF), which are freely available from Geofabrik and BBBike. Additionally, the package offers a comprehensive solution for convenient I/O operations and efficient storage capabilities for parsed OSM data within PostgreSQL databases. This means that users can easily read from and write to PostgreSQL databases, enabling efficient data manipulation, querying, and other essential tasks. Whether you are a researcher, practitioner, or simply interested in working with OSM data, PyDriosm can be useful and helpful to streamline your workflow and enhance your experience.

Cite as: Fu, Q. (2020). PyDriosm: An open-source tool for downloading, reading and PostgreSQL-based I/O of OpenStreetMap data. Zenodo. doi:10.5281/zenodo.4281194 For specific version references, please see the list of all versions.