From 38705c229ab4c1b4a047f8b140408b1ef456c49f Mon Sep 17 00:00:00 2001 From: Adam Holmberg Date: Fri, 29 May 2015 15:09:15 -0500 Subject: [PATCH] cqle: Note about Date type in upgrade guide --- docs/api/cassandra/cqlengine/columns.rst | 2 +- docs/cqlengine/upgrade_guide.rst | 14 ++++++++++++-- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/api/cassandra/cqlengine/columns.rst b/docs/api/cassandra/cqlengine/columns.rst index 7e3957e0..ae597a55 100644 --- a/docs/api/cassandra/cqlengine/columns.rst +++ b/docs/api/cassandra/cqlengine/columns.rst @@ -52,7 +52,7 @@ Columns of all types are initialized by passing :class:`.Column` attributes to t .. autoclass:: Counter -.. autoclass:: Date +.. autoclass:: Date(**kwargs) .. autoclass:: DateTime(**kwargs) diff --git a/docs/cqlengine/upgrade_guide.rst b/docs/cqlengine/upgrade_guide.rst index 831f94d7..9af58764 100644 --- a/docs/cqlengine/upgrade_guide.rst +++ b/docs/cqlengine/upgrade_guide.rst @@ -8,13 +8,23 @@ conversion to this package will still require certain minimal updates (namely, i **THERE IS ONE FUNCTIONAL CHANGE**, described in the first section below. -Functional Change -================= +Functional Changes +================== +List Prepend Reversing +---------------------- Legacy cqlengine included a workaround for a Cassandra bug in which prepended list segments were reversed (`CASSANDRA-8733 `_). As of this integration, this workaround is removed. The first released integrated version emits a warning when prepend is used. Subsequent versions will have this warning removed. +Date Column Type +---------------- +The Date column type in legacy cqlengine used a ``timestamp`` CQL type and truncated the time. +Going forward, the :class:`~.columns.Date` type represents a ``date`` for Cassandra 2.2+ +(`PYTHON-245 `_). +Users of the legacy functionality should convert models to use :class:`~.columns.DateTime` (which +uses ``timestamp`` internally), and use the build-in ``datetime.date`` for input values. + Remove cqlengine ================ To avoid confusion or mistakes using the legacy package in your application, it