From 6785e89cc04e58382ea2bff34a4ee66ebe4c4434 Mon Sep 17 00:00:00 2001 From: Simon Willison Date: Fri, 6 Nov 2020 17:22:24 -0800 Subject: [PATCH] Release 3.0a0 Refs #192 #193 #194 #196 #199 #198 #197 #200 --- docs/changelog.rst | 23 +++++++++++++++++++++++ setup.py | 2 +- 2 files changed, 24 insertions(+), 1 deletion(-) diff --git a/docs/changelog.rst b/docs/changelog.rst index 018d59c..5835f1c 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -2,6 +2,29 @@ Changelog =========== +.. _v3_0_a0: + +3.0a0 (2020-11-06) +------------------ + +This release introduces a new ``sqlite-utils search`` command for searching tables, see :ref:`cli_search`. (`#192 `__) + +The ``table.search()`` method has been redesigned, see :ref:`python_api_fts_search`. (`#197 `__) + +The release includes minor backwards-incompatible changes, hence the version bump to 3.0. Those changes, which should not affect most users, are: + +- The ``-c`` shortcut` option for outputting CSV is no longer available. The full ``--csv`` option is required instead. +- The ``-f`` shortcut for ``--fmt`` has also been removed - use ``--fmt``. +- The ``table.search()`` method now defaults to sorting by relevance, not sorting by ``rowid``. (`#198 `__) +- The ``table.search()`` method now returns a generator over a list of Python dictionaries. It previously returned a list of tuples. + +Also in this release: + +- The ``query``, ``tables``, ``rows`` and ``search`` CLI commands now accept a new ``--tsv`` option which outputs the results in TSV. (`#193 `__) +- A new ``table.virtual_table_using`` property reveals if a table is a virtual table, and returns the upper case type of virtual table (e.g. ``FTS4`` or ``FTS5``) if it is. It returns ``None`` if the table is not a virtual table. (`#196 `__) +- The new ``table.search_sql()`` method returns the SQL for searching a table, see :ref:`python_api_fts_search_sql`. +- ``sqlite-utils rows`` now accepts multiple optional ``-c`` parameters specifying the columns to return. (`#200 `__) + .. _v2_23: 2.23 (2020-10-28) diff --git a/setup.py b/setup.py index 9e1aea9..83c34d6 100644 --- a/setup.py +++ b/setup.py @@ -2,7 +2,7 @@ from setuptools import setup, find_packages import io import os -VERSION = "2.23" +VERSION = "3.0a0" def get_long_description():