v0.30.0
rathole-org/ratholev0.30.0Mar 24, 2026by github-actions[bot]
AI Summary
Added MongoDB and PostgreSQL connectors with streaming capabilities, enhanced array serialization support, and introduced async callbacks. Fixed the web-dashboard metrics database initialization.
Key Highlights
- New MongoDB connector (`pw.io.mongodb.read`) with snapshot and change stream support.
- New PostgreSQL connector (`pw.io.postgres.read`) utilizing the Write-Ahead Log (WAL).
- Support for `np.ndarray` serialization/deserialization in Postgres connectors.
- Introduced `dependency_overrides` parameter for Airbyte connectors.
- Async callback support (`pw.io.OnChangeCallbackAsync`) for Python write.
Breaking Changes
- MongoDB read/write now serialize ndarrays as nested BSON arrays to preserve shape.
- Dependencies for `pw.io.pyfilesystem.read` are no longer included in the default package.
New Features
- Connector: `pw.io.mongodb.read`
- Connector: `pw.io.postgres.read`
- Connector: `pw.io.postgres.write`
- Feature: Airbyte `dependency_overrides` parameter
Full Release Notes
### Added - `pw.io.mongodb.read` connector, which reads data from a MongoDB collection. The connector first delivers a full snapshot of the collection and then, if the streaming mode is used, subscribes to the change stream to receive incremental updates in real time. - `pw.io.postgres.read` connector, which reads data from a PostgreSQL table directly by parsing the Write-Ahead Log (WAL). - `pw.io.postgres.write` and `pw.io.postgres.read` now support serialization/deserialization of `np.ndarray` (`int`/`float` elements), homogeneous `tuple` and `list` (via Postgres `ARRAY`; multidimensional rectangular arrays supported). - `pw.io.airbyte.read` now accepts a `dependency_overrides` parameter, allowing users to pin specific versions of transitive dependencies (e.g. `airbyte-cdk`) installed into the connector's virtual environment. This unblocks connectors broken by upstream dependency changes without waiting for upstream fixes. ### Changed - **BREAKING**: `pw.io.mongodb.write` and `pw.io.mongodb.read` now serialize and deserialize `np.ndarray` columns as nested BSON arrays that preserve the array's shape. Previously, all ndarrays were flattened to a single BSON array regardless of dimensionality, making it impossible to reconstruct the original shape on read-back. For 1-D arrays the representation is identical to before (`[1, 2, 3]`); only multi-dimensional arrays are affected. - **BREAKING**: The dependencies for `pw.io.pyfilesystem.read` are no longer included in the default package installation. To install them, please use `pip install pathway[pyfilesystem]`. - Asynchronous callback for `pw.io.python.write` is now available as `pw.io.OnChangeCallbackAsync`. - `pw.run` and `pw.run_all` now have the `event_loop` parameter to support reusing async state across multiple graph runs. ### Fixed - `pathway web-dashboard` now waits for the metrics database to be created instead of terminating instantly.