Starstruk Logo MarkStarstruk

v0.30.0

semaphoreui/semaphorev0.30.0Mar 24, 2026by github-actions[bot]

AI Summary

This release introduces new MongoDB and PostgreSQL connectors for real-time data streaming, improves serialization support for arrays, and adds async callbacks to the Python write interface.

Key Highlights

  • New MongoDB read connector with snapshot and change stream support
  • New PostgreSQL read connector utilizing Write-Ahead Log (WAL)
  • Serialization support for numpy arrays, tuples, and lists in Postgres connectors
  • Async callback for `pw.io.python.write`
  • Event loop parameter for `pw.run` to support async state reuse

Breaking Changes

  • MongoDB read/write now serialize ndarrays as nested BSON arrays to preserve shape (previously flattened)
  • Dependencies for `pw.io.pyfilesystem.read` moved to optional extras (`pip install pathway[pyfilesystem]`)

New Features

  • MongoDB change stream connector
  • PostgreSQL WAL-based connector
  • Array serialization/deserialization in Postgres
  • Async write callbacks
  • Reusable event loops

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.