sqlite-utils 3.39__tar.gz → 4.0a1__tar.gz

{sqlite_utils-3.39/sqlite_utils.egg-info → sqlite_utils-4.0a1}/PKG-INFO

@@ -1,70 +1,56 @@
 Metadata-Version: 2.4
 Name: sqlite-utils
-Version: 3.39
+Version: 4.0a1
 Summary: CLI tool and Python library for manipulating SQLite databases
-Home-page: https://github.com/simonw/sqlite-utils
 Author: Simon Willison
-License: Apache License, Version 2.0
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/simonw/sqlite-utils
 Project-URL: Documentation, https://sqlite-utils.datasette.io/en/stable/
 Project-URL: Changelog, https://sqlite-utils.datasette.io/en/stable/changelog.html
-Project-URL: Source code, https://github.com/simonw/sqlite-utils
 Project-URL: Issues, https://github.com/simonw/sqlite-utils/issues
 Project-URL: CI, https://github.com/simonw/sqlite-utils/actions
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: End Users/Desktop
-Classifier: Topic :: Database
+Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Database
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sqlite-fts4
-Requires-Dist: click>=8.3.1
+Requires-Dist: click
 Requires-Dist: click-default-group>=1.2.3
-Requires-Dist: tabulate
-Requires-Dist: python-dateutil
 Requires-Dist: pluggy
-Requires-Dist: pip
+Requires-Dist: python-dateutil
+Requires-Dist: sqlite-fts4
+Requires-Dist: tabulate
 Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
 Requires-Dist: black>=24.1.1; extra == "test"
-Requires-Dist: hypothesis; extra == "test"
 Requires-Dist: cogapp; extra == "test"
+Requires-Dist: hypothesis; extra == "test"
+Requires-Dist: pytest; extra == "test"
 Provides-Extra: docs
+Requires-Dist: beanbag-docutils>=2.0; extra == "docs"
+Requires-Dist: codespell; extra == "docs"
 Requires-Dist: furo; extra == "docs"
+Requires-Dist: pygments-csv-lexer; extra == "docs"
 Requires-Dist: sphinx-autobuild; extra == "docs"
-Requires-Dist: codespell; extra == "docs"
 Requires-Dist: sphinx-copybutton; extra == "docs"
-Requires-Dist: beanbag-docutils>=2.0; extra == "docs"
-Requires-Dist: pygments-csv-lexer; extra == "docs"
 Provides-Extra: mypy
+Requires-Dist: data-science-types; extra == "mypy"
 Requires-Dist: mypy; extra == "mypy"
 Requires-Dist: types-click; extra == "mypy"
-Requires-Dist: types-tabulate; extra == "mypy"
-Requires-Dist: types-python-dateutil; extra == "mypy"
 Requires-Dist: types-pluggy; extra == "mypy"
-Requires-Dist: data-science-types; extra == "mypy"
+Requires-Dist: types-python-dateutil; extra == "mypy"
+Requires-Dist: types-tabulate; extra == "mypy"
 Provides-Extra: flake8
 Requires-Dist: flake8; extra == "flake8"
-Provides-Extra: tui
-Requires-Dist: trogon; extra == "tui"
-Dynamic: author
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license
+Requires-Dist: flake8-pyproject; extra == "flake8"
 Dynamic: license-file
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
 
 # sqlite-utils
 

{sqlite_utils-3.39 → sqlite_utils-4.0a1}/docs/changelog.rst

@@ -4,16 +4,31 @@
  Changelog
 ===========
 
-.. _v3_39:
+.. _v4_0a1:
 
-3.39 (2025-11-24)
------------------
+4.0a1 (2025-11-23)
+------------------
+
+- **Breaking change**: The ``db.table(table_name)`` method now only works with tables. To access a SQL view use ``db.view(view_name)`` instead. (:issue:`657`)
+- The ``table.insert_all()`` and ``table.upsert_all()`` methods can now accept an iterator of lists or tuples as an alternative to dictionaries. The first item should be a list/tuple of column names. See :ref:`python_api_insert_lists` for details. (:issue:`672`)
+- **Breaking change**: The default floating point column type has been changed from ``FLOAT`` to ``REAL``, which is the correct SQLite type for floating point values. This affects auto-detected columns when inserting data. (:issue:`645`)
+- Now uses ``pyproject.toml`` in place of ``setup.py`` for packaging. (:issue:`675`)
+- Tables in the Python API now do a much better job of remembering the primary key and other schema details from when they were first created. (:issue:`655`)
+- **Breaking change**: The ``table.convert()`` and ``sqlite-utils convert`` mechanisms no longer skip values that evaluate to ``False``. Previously the ``--skip-false`` option was needed, this has been removed. (:issue:`542`)
+- **Breaking change**: Tables created by this library now wrap table and column names in ``"double-quotes"`` in the schema. Previously they would use ``[square-braces]``. (:issue:`677`)
+- The ``--functions`` CLI argument now accepts a path to a Python file in addition to accepting a string full of Python code. It can also now be specified multiple times. (:issue:`659`)
+- **Breaking change:** Type detection is now the default behavior for the ``insert`` and ``upsert`` CLI commands when importing CSV or TSV data. Previously all columns were treated as ``TEXT`` unless the ``--detect-types`` flag was passed. Use the new ``--no-detect-types`` flag to restore the old behavior. The ``SQLITE_UTILS_DETECT_TYPES`` environment variable has been removed. (:issue:`679`)
 
-- Fixed a bug with ``sqlite-utils install`` when the tool had been installed using ``uv``. (:issue:`687`)
-- The ```--functions``` argument now optionally accepts a path to a Python file as an alternative to a string full of code, and can be specified multiple times - see :ref:`cli_query_functions`.  (:issue:`659`)
-- ``sqlite-utils`` now requires on Python 3.10 or higher.
+.. _v4_0a0:
+
+4.0a0 (2025-05-08)
+------------------
 
-`sqlite-utils 4.0a1 <https://sqlite-utils.datasette.io/en/latest/changelog.html#a1-2025-11-23>`__ is now available as an alpha with some `minor breaking changes <https://simonwillison.net/2025/Nov/24/sqlite-utils-40a1/>`__.
+- Upsert operations now use SQLite's ``INSERT ... ON CONFLICT SET`` syntax on all SQLite versions later than 3.23.1. This is a very slight breaking change for apps that depend on the previous ``INSERT OR IGNORE`` followed by ``UPDATE`` behavior. (:issue:`652`)
+- Python library users can opt-in to the previous implementation by passing ``use_old_upsert=True`` to the ``Database()`` constructor, see :ref:`python_api_old_upsert`.
+- Dropped support for Python 3.8, added support for Python 3.13. (:issue:`646`)
+- ``sqlite-utils tui`` is now provided by the `sqlite-utils-tui <https://github.com/simonw/sqlite-utils-tui>`__ plugin. (:issue:`648`)
+- Test suite now also runs against SQLite 3.23.1, the last version (from 2018-04-10) before the new ``INSERT ... ON CONFLICT SET`` syntax was added. (:issue:`654`)
 
 .. _v3_38:
 
@@ -122,7 +137,7 @@ This release introduces a new :ref:`plugin system <plugins>`. Read more about th
 3.32 (2023-05-21)
 -----------------
 
-- New experimental ``sqlite-utils tui`` interface for interactively building command-line invocations, powered by `Trogon <https://github.com/Textualize/trogon>`__. This requires an optional dependency, installed using ``sqlite-utils install trogon``. There is a screenshot :ref:`in the documentation <cli_tui>`. (:issue:`545`)
+- New experimental ``sqlite-utils tui`` interface for interactively building command-line invocations, powered by `Trogon <https://github.com/Textualize/trogon>`__. This requires an optional dependency, installed using ``sqlite-utils install trogon``. (:issue:`545`)
 - ``sqlite-utils analyze-tables`` command (:ref:`documentation <cli_analyze_tables>`) now has a ``--common-limit 20`` option for changing the number of common/least-common values shown for each column. (:issue:`544`)
 - ``sqlite-utils analyze-tables --no-most`` and ``--no-least`` options for disabling calculation of most-common and least-common values.
 - If a column contains only ``null`` values, ``analyze-tables`` will no longer attempt to calculate the most common and least common values for that column. (:issue:`547`)

{sqlite_utils-3.39 → sqlite_utils-4.0a1}/docs/cli-reference.rst

@@ -65,7 +65,6 @@ This page lists the ``--help`` for every ``sqlite-utils`` CLI sub-command.
         "create-spatial-index": "cli_spatialite_indexes",
         "install": "cli_install",
         "uninstall": "cli_uninstall",
-        "tui": "cli_tui",
     }
     commands.sort(key = lambda command: go_first.index(command) if command in go_first else 999)
     cog.out("\n")
@@ -286,7 +285,8 @@ See :ref:`cli_inserting_data`, :ref:`cli_insert_csv_tsv`, :ref:`cli_insert_unstr
       --alter                   Alter existing table to add any missing columns
       --not-null TEXT           Columns that should be created as NOT NULL
       --default <TEXT TEXT>...  Default value that should be set for a column
-      -d, --detect-types        Detect types for columns in CSV/TSV data
+      -d, --detect-types        Detect types for columns in CSV/TSV data (default)
+      --no-detect-types         Treat all CSV/TSV columns as TEXT
       --analyze                 Run ANALYZE at the end of this operation
       --load-extension TEXT     Path to SQLite extension, with optional :entrypoint
       --silent                  Do not show progress bar
@@ -343,7 +343,8 @@ See :ref:`cli_upsert`.
       --alter                   Alter existing table to add any missing columns
       --not-null TEXT           Columns that should be created as NOT NULL
       --default <TEXT TEXT>...  Default value that should be set for a column
-      -d, --detect-types        Detect types for columns in CSV/TSV data
+      -d, --detect-types        Detect types for columns in CSV/TSV data (default)
+      --no-detect-types         Treat all CSV/TSV columns as TEXT
       --analyze                 Run ANALYZE at the end of this operation
       --load-extension TEXT     Path to SQLite extension, with optional :entrypoint
       --silent                  Do not show progress bar
@@ -458,8 +459,8 @@ See :ref:`cli_transform_table`.
               --rename column2 column_renamed
 
     Options:
-      --type <TEXT CHOICE>...         Change column type to INTEGER, TEXT, FLOAT or
-                                      BLOB
+      --type <TEXT CHOICE>...         Change column type to INTEGER, TEXT, FLOAT,
+                                      REAL or BLOB
       --drop TEXT                     Drop this column
       --rename <TEXT TEXT>...         Rename this column to X
       -o, --column-order TEXT         Reorder columns
@@ -654,7 +655,6 @@ See :ref:`cli_convert`.
       --output-type [integer|float|blob|text]
                                       Column type to use for the output column
       --drop                          Drop original column afterwards
-      --no-skip-false                 Don't skip falsey values
       -s, --silent                    Don't show a progress bar
       --pdb                           Open pdb debugger on first error
       -h, --help                      Show this message and exit.
@@ -1045,23 +1045,6 @@ disable-fts
       -h, --help             Show this message and exit.
 
 
-.. _cli_ref_tui:
-
-tui
-===
-
-See :ref:`cli_tui`.
-
-::
-
-    Usage: sqlite-utils tui [OPTIONS]
-
-      Open Textual TUI.
-
-    Options:
-      -h, --help  Show this message and exit.
-
-
 .. _cli_ref_optimize:
 
 optimize
@@ -1161,7 +1144,7 @@ See :ref:`cli_add_column`.
 ::
 
     Usage: sqlite-utils add-column [OPTIONS] PATH TABLE COL_NAME
-                          [[integer|int|float|text|str|blob|bytes]]
+                          [[integer|int|float|real|text|str|blob|bytes]]
 
       Add a column to the specified table