Release 2.3.0

[mikeqfu]

Summary

This PR merges the develop branch into master to release v2.3.0. It consolidates major refactoring cycles that modernize the core architecture of pydriosm, updates the build system, and ensures support for Python 3.12 and Pandas 3.0+.

Integrated workstreams

Subpackage refactoring

• Downloader (Refactor the downloader subpackage #32): Modularized Geofabrik and BBBike providers into discrete internal modules and improved web-parsing logic.
• Reader (Refactor the reader subpackage #33): Standardized OSM data parsing across Shapefile, PBF, and VAR formats. Implemented safer defaults, specifically setting download=False to prevent unintended network overhead.
• I/O & core infrastructure (Refactor I/O and core infrastructure #34): * Decomposed the ios module into specialized components: _base.py, _pgsql_osm.py, and _pbf_importer.py.
• Hardened validation logic by replacing assert statements with production-safe exception handling (KeyError, ValueError).
• Migrated package configuration and metadata to pyproject.toml.

Release Preparation

• Environment compatibility: Full validation for Python >= 3.12.
• Documentation: Finalized public API docstrings in reST format and updated the documentation build configuration.
• Version update: Bumped version to 2.3.0 and updated CHANGELOG.md.

Code quality & maintenance

• Linter resolution: Addressed unused imports and f-string warnings to maintain a clean codebase.
• Geometry processing: Refined attribute-based geometry detection to ensure seamless integration with both standard Pandas 3.0+ DataFrames and GeoPandas GeoDataFrames.
• Dependency management: Synchronized requirements.txt with the new modular dependency structure.

Checklist

• All feature branch tests (Refactor the downloader subpackage #32, Refactor the reader subpackage #33, Refactor I/O and core infrastructure #34) pass on the final develop build.
• CHANGELOG.md is updated and reflects key changes since v2.2.0.
• Documentation cross-references verified via local Sphinx build.
• Build artifacts (wheels/sdist) verified for successful installation.