Trino

* Add support for Python 3.12 and drop support for Python 3.7 and PyPy 3.8
which are end-of-life.
([438](https://github.com/trinodb/trino-python-client/issues/438))
* Add support for `JSON` data type to SQLAlchemy dialect.
([387](https://github.com/trinodb/trino-python-client/issues/387))
* Add support for `IGNORE NULLS` in window functions when using SQLAlchemy.
([429](https://github.com/trinodb/trino-python-client/issues/429))
* Add support for `MAP` type to SQLAlchemy dialect.
([397](https://github.com/trinodb/trino-python-client/issues/397))
* Add support for per-user OAuth2 token cache if the `user` is provided when
creating the connection. If `user` is not provided the previous behaviour of
a per-host token cache is used.
([430](https://github.com/trinodb/trino-python-client/issues/430))
* Add support to configure log level for all modules via the root logger. The
root logger is named `trino`.
([434](https://github.com/trinodb/trino-python-client/issues/434))
* Allow using `keyring.backends.null.Keyring` to disable keyring when using
OAuth2.
([431](https://github.com/trinodb/trino-python-client/issues/431))
* Fix `fetchall` returning already returned rows if called after `fetchone` or
`fetchmany`.
([414](https://github.com/trinodb/trino-python-client/issues/414))
* Fix possible failures when retrieving query results if the server returns
empty data.
([443](https://github.com/trinodb/trino-python-client/issues/443))
* Fix error when closing a cursor without executing a query.
([428](https://github.com/trinodb/trino-python-client/issues/428))
* Fix `get_indexes` in SQLAlchemy to not fail when called for non-Hive tables.
([426](https://github.com/trinodb/trino-python-client/issues/426))
* Fix reading and writing `MAP` types with boolean or integer keys.
([441](https://github.com/trinodb/trino-python-client/issues/441))
* Fix incompatibility when using trino-python-client with
[Ray](https://github.com/ray-project/ray).
([420](https://github.com/trinodb/trino-python-client/issues/420))

* Implement `get_catalog_names` for SQLAlchemy to get the list of catalogs
present on the cluster.
([401](https://github.com/trinodb/trino-python-client/issues/401))
* Use `OAuth2Authentication` if `externalAuthentication` parameter is set on
the connection url when using SQLAlchemy.
([343](https://github.com/trinodb/trino-python-client/issues/343))
* Set the `User-Agent` HTTP header in all requests to `Trino Python
Client/<client_version>`.
([411](https://github.com/trinodb/trino-python-client/issues/411))
* Raise `TrinoConnectionError` for all connection related errors.
([364](https://github.com/trinodb/trino-python-client/issues/364))

* Fix SQLAlchemy URL failing to parse if `legacy_prepared_statements` parameter
was specified.
([380](https://github.com/trinodb/trino-python-client/issues/380))
* Fix more than required `EXECUTE IMMEDIATE` queries being executed when
`legacy_prepared_statements` parameter wasn't explicitly set.
([380](https://github.com/trinodb/trino-python-client/issues/380))

* Queries with parameters now uses `EXECUTE IMMEDIATE` instead of `PREPARE`,
`EXECUTE` and `DEALLOCATE` if the server supports `EXECUTE IMMEDIATE`. If
`EXECUTE IMMEDIATE` is not support the client falls back to using `PREPARE`,
`EXECUTE` and `DEALLOCATE`. If you want to always use `PREPARE`, `EXECUTE`
and `DEALLOCATE` set the kwarg `legacy_prepared_statements` to `True`.
([375](https://github.com/trinodb/trino-python-client/issues/375))

* Reduce the number of times `SELECT version()` query is sent to Trino when
using SQLAlchemy.
([371](https://github.com/trinodb/trino-python-client/issues/371))
* Fix `TIMESTAMP WITH TIME ZONE` being mapped to incorrect zones.
([366](https://github.com/trinodb/trino-python-client/issues/366))

* Fix handling of `Decimal` params which use scientific notation.
([347](https://github.com/trinodb/trino-python-client/issues/347))
* Map Trino `UUID` type to Python `uuid.UUID`.
([354](https://github.com/trinodb/trino-python-client/issues/354))
* Map `sqlalchemy.Uuid` type to Trino `UUID`.
([359](https://github.com/trinodb/trino-python-client/issues/359))
* Support using timezone aware `datetime.time` params in prepared statements.
([360](https://github.com/trinodb/trino-python-client/issues/360))
* Allow accessing `ROW` type fields using their names in addition to their indices.
([338](https://github.com/trinodb/trino-python-client/issues/338))
* Interpret `roles` without catalog name as system roles for convenience.
([341](https://github.com/trinodb/trino-python-client/issues/341))