Version bumped to 0.2.4

CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## Unreleased
 
+## [0.2.4] - 2022-06-13
+### Added
+- ``dict`` and ``namedtuple`` cursor factories. Solves issue [#290](https://github.com/mymarilyn/clickhouse-driver/issues/290).
+- Geo types: Point, Ring, Polygon, MultiPolygon. Solves issue [#228](https://github.com/mymarilyn/clickhouse-driver/issues/228).
+- NumPy Tuple type.
+- ``input_format_null_as_default`` option for NULL insert into not NULL columns. Solves issue [#312](https://github.com/mymarilyn/clickhouse-driver/issues/312).
+- Chunk size controlling in ``execute_iter`` by parameter ``chunk_size``. Solves issue [#314](https://github.com/mymarilyn/clickhouse-driver/issues/314). Pull request [#315](https://github.com/mymarilyn/clickhouse-driver/pull/315) by [MIracleyin](https://github.com/MIracleyin).
+
+### Fixed
+- Decimal precision check on INSERT. Solves issue [#289](https://github.com/mymarilyn/clickhouse-driver/issues/289). Pull request [#295](https://github.com/mymarilyn/clickhouse-driver/pull/295) by [joelynch](https://github.com/joelynch).
+- Using server's default database instead or ``default``. Solves issue [#309](https://github.com/mymarilyn/clickhouse-driver/issues/309).
+- ``python_requires`` to valid PEP 440 syntax in ``setup.py``. Pull request [#291](https://github.com/mymarilyn/clickhouse-driver/pull/291) by [LSturtew](https://github.com/LSturtew).
+
+### Changed
+- Protocol version bumped to 54453.
+
 ## [0.2.3] - 2022-02-07
 ### Added
 - `tzlocal`>=4.0 support. Pull request [#263](https://github.com/mymarilyn/clickhouse-driver/pull/263) by [azat](https://github.com/azat).
@@ -382,7 +398,8 @@
 - Date/DateTime types.
 - String types.
 
-[Unreleased]: https://github.com/mymarilyn/clickhouse-driver/compare/0.2.3...HEAD
+[Unreleased]: https://github.com/mymarilyn/clickhouse-driver/compare/0.2.4...HEAD
+[0.2.4]: https://github.com/mymarilyn/clickhouse-driver/compare/0.2.3...0.2.4
 [0.2.3]: https://github.com/mymarilyn/clickhouse-driver/compare/0.2.2...0.2.3
 [0.2.2]: https://github.com/mymarilyn/clickhouse-driver/compare/0.2.1...0.2.2
 [0.2.1]: https://github.com/mymarilyn/clickhouse-driver/compare/0.2.0...0.2.1

docs/misc.rst

@@ -124,3 +124,18 @@ available. Just specify new settings and it will work.
 
         >>> client = Client('localhost', settings={'brand_new_setting': 42})
         >>> client.execute('SELECT 1')
+
+
+Inserting NULL into NOT NULL columns
+------------------------------------
+
+*New in version 0.2.4.*
+
+Client option ``input_format_null_as_default`` does the same thing as in
+``clickhouse-client``. But in this package it's disabled by default. You should
+enable it if you want cast ``None`` value into default value for current type:
+
+    .. code-block:: python
+
+        >>> settings = {'input_format_null_as_default': True}
+        >>> client = Client('localhost', settings=settings)

docs/types.rst

@@ -407,3 +407,18 @@ Map(key, value)
 INSERT types: :class:`dict`.
 
 SELECT type: :class:`dict`.
+
+
+Geo
+---
+
+*New in version 0.2.4.*
+
+Point, Ring, Polygon, MultiPolygon.
+
+These types are just aliases:
+
+* Point: Tuple(Float64, Float64)
+* Ring: Array(Point)
+* Polygon: Array(Ring)
+* MultiPolygon: Array(Polygon)

setup.py

@@ -62,14 +62,16 @@ def read_version():
 
     extensions = cythonize(extensions, compiler_directives=compiler_directives)
 
+github_url = 'https://github.com/mymarilyn/clickhouse-driver'
+
 setup(
     name='clickhouse-driver',
     version=read_version(),
 
     description='Python driver with native interface for ClickHouse',
     long_description=long_description,
 
-    url='https://github.com/mymarilyn/clickhouse-driver',
+    url=github_url,
 
     author='Konstantin Lebedev',
     author_email='kostyan.lebedev@gmail.com',
@@ -115,6 +117,7 @@ def read_version():
 
     project_urls={
         'Documentation': 'https://clickhouse-driver.readthedocs.io',
+        'Changes': github_url + '/blob/master/CHANGELOG.md'
     },
     packages=find_packages('.', exclude=['tests*']),
     python_requires='>=3.4, <4',