v0.30.0
pathwaycom/pathwayv0.30.0Mar 24, 2026by github-actions[bot]
AI Summary
This release adds MongoDB and PostgreSQL connectors, introduces array shape preservation for numpy arrays, and adds async support with event loop parameters.
Key Highlights
- New MongoDB read connector with change stream support
- New PostgreSQL read connector using WAL parsing
- Breaking change: MongoDB connectors now preserve np.ndarray shape
- Breaking change: pyfilesystem dependencies moved to optional installation
- Added event_loop parameter for pw.run and pw.run_all
Breaking Changes
- MongoDB connectors now serialize np.ndarray as nested BSON arrays preserving shape (previously flattened)
- pyfilesystem dependencies no longer included in default package - requires pip install pathway[pyfilesystem]
New Features
- pw.io.mongodb.read connector with change stream subscription
- pw.io.postgres.read connector using WAL parsing
- np.ndarray and homogeneous tuple/list serialization for PostgreSQL
- airbyte.read dependency_overrides parameter
- pw.io.OnChangeCallbackAsync for python.write
- event_loop parameter for pw.run and pw.run_all
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.