sqlite-utils 4.2 crashes with ModuleNotFoundError: No module named 'typing_extensions'

uv run --with sqlite-utils==4.2 sqlite-utils --help

Outputs:

  File "/Users/simon/.cache/uv/builds-v0/.tmpne5gey/bin/sqlite-utils", line 4, in <module>
    from sqlite_utils.cli import cli
  File "/Users/simon/.cache/uv/archive-v0/MPQM9SkBDiPBgG2rUmdFt/lib/python3.14/site-packages/sqlite_utils/__init__.py", line 1, in <module>
    from .db import Database
  File "/Users/simon/.cache/uv/archive-v0/MPQM9SkBDiPBgG2rUmdFt/lib/python3.14/site-packages/sqlite_utils/db.py", line 27, in <module>
    from typing_extensions import Self
ModuleNotFoundError: No module named 'typing_extensions'

Recreated locally with:

/tmp/ooo/sqlite-utils % rm -rf .venv
/tmp/ooo/sqlite-utils % uv run --no-default-groups sqlite-utils --help
Using CPython 3.14.3
Creating virtual environment at: .venv
Installed 9 packages in 16ms
Traceback (most recent call last):
  File "/private/tmp/ooo/sqlite-utils/.venv/bin/sqlite-utils", line 4, in <module>
    from sqlite_utils.cli import cli
  File "/private/tmp/ooo/sqlite-utils/sqlite_utils/__init__.py", line 1, in <module>
    from .db import Database
  File "/private/tmp/ooo/sqlite-utils/sqlite_utils/db.py", line 27, in <module>
    from typing_extensions import Self
ModuleNotFoundError: No module named 'typing_extensions'

Problem is here:

sqlite-utils/sqlite_utils/db.py

Line 27 in 1d98613

from typing_extensions import Self

That snuck in with this commit: 69a1c0d#diff-1f7b5e1a1798b4dc7bb8c5e8f173682724dd3e9e5defceb9f888d0c22588d4d9

Refs:

Fixes for Ruff>=0.16.0 #814

I'm going to add uv run --no-default-groups sqlite-utils --help to test.yml to avoid this ever happening again.

I considered yanking the release from PyPI but that's not necessary since the workaround for people affected by it is to add typing-extensions as a dependency (if they do not have it yet) - or wait a few minutes for 4.2.1.

Remove from typing_extensions import Self, refs #842

Revert "Remove from typing_extensions import Self, refs #842"

Remove from typing_extensions import Self, refs #842

Release 4.2.1

Run no-default-groups smoke test from Justfile

sqlite-utils/Justfile

Lines 4 to 9 in 56dd097

    
           # Run pytest with supplied options 
        
           @test *options: test-no-dev-dependencies 
        
             uv run pytest {{options}} 
        
           @test-no-dev-dependencies: 
        
             uv run --isolated --no-default-groups sqlite-utils --help > /dev/null

So now just test-no-dev-dependencies runs that smoke test, and just test runs it before running everything else.

The --isolated means that even if there is a .venv/ it will be ignored.

Fix for sqlite-utils 4.2 crashing bug (simonw#843)

Navigation Menu

Repository navigation

sqlite-utils 4.2 crashes with ModuleNotFoundError: No module named 'typing_extensions' #842

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

	# Run pytest with supplied options
	@test *options: test-no-dev-dependencies
	uv run pytest {{options}}

	@test-no-dev-dependencies:
	uv run --isolated --no-default-groups sqlite-utils --help > /dev/null

sqlite-utils 4.2 crashes with ModuleNotFoundError: No module named 'typing_extensions' #842

Description

Activity

simonw commented on Aug 13, 2026

simonw commented on Aug 13, 2026

simonw commented on Aug 13, 2026

simonw commented on Aug 13, 2026

simonw commented on Aug 13, 2026

simonw commented on Aug 14, 2026

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions