Joe/remove pytyped and other small cleanup issues (#693)

* remove pytyped

* remove reference to old VERSION file

* readme correctness updates and clarifications

Author: joe-clickhouse

CHANGELOG.md

@@ -30,6 +30,9 @@ The supported method of passing ClickHouse server settings is to prefix such arg
 - SQLAlchemy: Add missing Replicated table engine variants: `ReplicatedReplacingMergeTree`, `ReplicatedCollapsingMergeTree`, `ReplicatedVersionedCollapsingMergeTree`, and `ReplicatedGraphiteMergeTree`. Closes [#687](https://github.com/ClickHouse/clickhouse-connect/issues/687)
 - Lazy imports for optional dependencies (numpy, pandas, pyarrow, polars). If installed, these heavy libraries are no longer imported at `import clickhouse_connect` time. They are only imported when features that need them are actually used. The C/Numpy optimization bridge is also deferred. This speeds up bare import time of `clickhouse-connect` about 4X in environments where all four are installed. Closes [#589](https://github.com/ClickHouse/clickhouse-connect/issues/589)
 
+### Other
+- Remove `py.typed` marker file. The package does not have comprehensive type annotations, so the PEP 561 marker was causing false type errors for mypy/pyright users. Closes [#691](https://github.com/ClickHouse/clickhouse-connect/issues/691)
+
 ### Bug Fixes
 - SQLAlchemy: Fix `.final()` and `.sample()` silently overwriting each other when chained. Both methods now store modifiers as custom attributes on the `Select` instance and render them during compilation, replacing the previous `with_hint()` approach that only allowed one hint per table. Chaining in either order (e.g. `select(t).final().sample(0.1)`) correctly produces `FROM t FINAL SAMPLE 0.1`. Also fixes rendering for aliased tables (`FROM t AS u FINAL`) and supports explicit table targeting in joins. Fixes [#658](https://github.com/ClickHouse/clickhouse-connect/issues/658)
 - SQLAlchemy: Fix `sqlalchemy.values()` to generate ClickHouse's `VALUES` table function syntax. The compiler now emits `VALUES('col1 Type1, col2 Type2', ...)` with the column structure as the first argument, instead of the standard SQL form that places column names after the alias. Generic SQLAlchemy types are mapped to ClickHouse equivalents (e.g. `Integer` to `Int32`, `String` to `String`). Also handles CTE usage by wrapping in `SELECT * FROM VALUES(...)`. Fixes [#681](https://github.com/ClickHouse/clickhouse-connect/issues/681)

README.md

@@ -2,7 +2,7 @@
 
 A high performance core database driver for connecting ClickHouse to Python, Pandas, and Superset
 
-* Pandas DataFrames (numpy and arrow-backed)
+* Pandas DataFrames (numpy and arrow-backed). Pandas 2.x and above only, 1.x is deprecated and will be dropped in 1.0.
 * Numpy Arrays
 * PyArrow Tables
 * Polars DataFrames
@@ -17,7 +17,8 @@ ClickHouse Connect currently uses the ClickHouse HTTP interface for maximum comp
 pip install clickhouse-connect
 ```
 
-ClickHouse Connect requires Python 3.9 or higher. We officially test against Python 3.9 through 3.13.
+ClickHouse Connect requires Python 3.9 or higher. We officially test against Python 3.10 through 3.14.
+Python 3.9 is deprecated and support will be removed entirely in 1.0.
 
 ### Superset Connectivity
 
@@ -52,9 +53,14 @@ are not implemented. The dialect is best suited for SQLAlchemy Core usage and Su
 
 ### Asyncio Support
 
-ClickHouse Connect provides an async wrapper, so that it is possible to use the client in an `asyncio` environment.
+ClickHouse Connect provides an `AsyncClient` for use in `asyncio` environments.
 See the [run_async example](./examples/run_async.py) for more details.
 
+The current `AsyncClient` is a thread-pool executor wrapper around the synchronous client and is deprecated.
+In 1.0.0 it will be replaced by a fully native async implementation. The API surface is the same,
+with one difference: you will no longer be able to create a sync client first and pass it to the
+`AsyncClient` constructor. Instead, use `clickhouse_connect.get_async_client()` directly.
+
 ### Complete Documentation
 
 The documentation for ClickHouse Connect has moved to

clickhouse_connect/py.typed

@@ -51,7 +51,6 @@ def run_setup(try_c: bool = True):
         version=version,
         long_description=long_desc,
         long_description_content_type='text/markdown',
-        package_data={'clickhouse_connect': ['VERSION', 'py.typed']},
         url='https://github.com/ClickHouse/clickhouse-connect',
         packages=find_packages(exclude=['tests*']),
         python_requires='>=3.9,<3.15',