Саймон Уиллисон переписал Datasette Lite: Datasette целиком в браузере

Саймон Уиллисон переписал Datasette Lite: Datasette целиком в браузере

Саймон Уиллисон выпустил полную переработку Datasette Lite, своего порта Python-приложения Datasette, которое запускается прямо в браузере через WebAssembly и Pyodide. Новая версия построена на service workers (сервис-воркерах), и, по словам автора, теперь она почти неотличима от настоящего серверного приложения.

Через специально составленный URL на lite.datasette.io можно: загрузить клиентский Datasette для просмотра любой базы SQLite, файла JSON, CSV или SQL-скрипта; выбрать выпущенную версию Datasette из PyPI; загрузить конкретный коммит, тег или ветку из репозитория Datasette на GitHub; выбрать одну из более чем 100 версий SQLite; установить дополнительные плагины Datasette из PyPI или по ссылкам на wheel-файлы, включая JavaScript-инструменты визуализации. По мысли автора, это удобно для ссылок на демо недоделанных функций и воспроизведение багов без поднятия полноценного веб-сервера.

В пример приведена ссылка, которая ставит плагин datasette-maplibre (?install=), грузит базу SQLite с GeoJSON-контурами стран по адресу из параметра url, подтягивает файл metadata.yml (HTML-описания таблиц и главной страницы) и через фрагмент после знака # открывает конкретное представление capitals_and_countries с картой, приближенной к заданной точке и окрашенной по столбцу continent. Параметр ?install= можно повторять для нескольких плагинов. Файлы по url должны отдаваться с открытыми CORS-заголовками, поэтому автор хранит их в Gist. Уиллисон уже использует Datasette Lite в разработке: в задаче про баг пагинации он показал ссылками, что на версии 1.0a42 вторая страница пустая, а на 1.0a43 ошибка исправлена.

Первая версия появилась в 2022 году, отчасти как шутка. Это был хак: Datasette работал в Pyodide-воркере, запросы имитировались, а готовый HTML вставлялся в страницу через innerHTML. Из-за этого не работал любой JavaScript (теги script в innerHTML не выполняются), а дополнительные JS- и CSS-файлы не загружались.

Новый подход: service worker регистрируется для всего домена lite.datasette.io и перехватывает HTTP-запросы. Родительская страница создаёт iframe, который запрашивает страницы Datasette по обычным адресам с префиксом вида /app/aa94e6851595/, главную, страницы таблиц, JS и CSS. Префикс с случайным идентификатором сессии нужен из-за нескольких вкладок: service worker общий, и без префикса все вкладки делили бы один экземпляр Datasette, независимо от плагинов и настроек в их URL. По идентификатору запросы направляются через родительскую страницу в веб-воркер с отдельным экземпляром Datasette. Веб-воркер всё равно нужен, потому что Pyodide внутри service worker не сможет хранить состояние дольше примерно 30 секунд (зависит от браузера). Систему начали в мае как исследовательский набросок, сгенерированный с помощью Claude Opus 4.8, а уверенность выпустить её в работу, по словам автора, появилась только в ноябре, с Claude Fable 5.2, который также сгенерировал SVG-схемы для README.

Дополнительная функция, выбор версии SQLite, добавленная накануне вечером. Datasette должен работать с любой версией SQLite начиная с 3.25 (сентябрь 2018 года); с тех пор вышло ещё 87 релизов. Новый репозиторий datasette/pysqlite3-wasm-wheels содержит скомпилированные в WebAssembly wheel-пакеты pysqlite3 для 163 версий SQLite (пример имени: pysqlite3-0.6.2-3.54.1-cp314-cp314-pyemscripten_2026_0_wasm32.whl, для SQLite 3.54.1, самой свежей версии). Параметр ?sqlite= принимает номер версии, находит нужный wheel, ставит его в Pyodide и настраивает Datasette на его использование. Кроме того, Claude Fable 5.2 построил для автора инструмент сравнения результата SQL-запроса на выбранных версиях SQLite; в примере показано различие выражения select json_object('a', (select json_array(1))) между 3.54.0 и 3.54.1.

Автор подчёркивает, что приём не уникален для Datasette: почти любое Python-приложение должно суметь работать в браузере на WebAssembly и Pyodide как дешёвое окружение для предпросмотра, демонстраций и воспроизведения багов. Расширения на C и Rust раньше мешали, но, по его словам, любой хороший кодинг-агент теперь компилирует их в совместимый с Pyodide WebAssembly, а с PEP 783 (апрель 2026 года) такие пакеты можно публиковать в PyPI. Оговорка, базы данных: SQLite проблем не создаёт, а PostgreSQL или MySQL в WebAssembly запустить возможно, но это малоизведанный путь.

Ключевые факты

  • Datasette Lite полностью переписан на service workers: серверное приложение Datasette в браузере, по словам автора, почти неотличимо от настоящего, а JavaScript и CSS теперь работают.
  • Через параметры URL можно выбрать версию Datasette, коммит, тег или ветку GitHub, плагины, базу и метаданные, то есть сделать ссылку-демо или воспроизведение бага без сервера.
  • Новый параметр ?sqlite= позволяет выбрать версию SQLite: в репозитории datasette/pysqlite3-wasm-wheels лежат wheel-пакеты pysqlite3 для 163 версий, а в списке возможностей заявлено более 100 версий.
  • Схема работы: общий service worker на домене, iframe с префиксом /app/<сессия>/ для каждой вкладки и отдельный веб-воркер с Pyodide, потому что в service worker состояние живёт лишь около 30 секунд.
  • По мнению автора, почти любое Python-приложение можно запустить так же; слабое место, базы вроде PostgreSQL и MySQL в WebAssembly.

Почему это важно

Datasette Lite начинался в 2022 году как полушутка и хак с подстановкой HTML через innerHTML, из-за чего любые функции на JavaScript не работали. Переход на service workers убирает это ограничение: страницы, JS и CSS приходят по обычным адресам Datasette, поэтому плагины с визуализацией, например datasette-maplibre, работают так же, как на сервере. Это превращает порт в практичный способ делиться живыми демо, не поднимая серверную инфраструктуру. Побочный эффект, возможность запускать Datasette на любой из версий SQLite, что полезно для отладки странных случаев и показа новых возможностей SQLite.

Кому это важно

В первую очередь разработчикам и пользователям Datasette и его плагинов: автор сам уже применяет ссылки на Datasette Lite в обсуждении багов, например при проверке пагинации на версиях 1.0a42 и 1.0a43. Также интересно тем, кто занимается SQLite и ищет различия между его версиями, и авторам Python-приложений, которым нужны дешёвые окружения для предпросмотра. Тем, кто следит за Pyodide и WebAssembly в Python, пригодятся описанная схема с сервис-воркером и упоминание PEP 783.

Как это применить

Достаточно собрать ссылку на lite.datasette.io с нужными параметрами: ?install= для плагинов (можно повторять), url= для базы SQLite, JSON, CSV или SQL-скрипта, metadata= для файла метаданных, ref= для версии, тега, коммита или ветки Datasette, sql= для SQL-скрипта по ссылке (как в примере с багом пагинации), sqlite= для версии SQLite, а после знака #, адрес внутри Datasette. Файлы по ссылкам должны отдаваться с открытыми CORS-заголовками; автор для этого хранит их в Gist. Полный список аргументов описан в README Datasette Lite. Для сравнения запросов на разных версиях SQLite автор сделал отдельный инструмент на странице datasette.github.io/pysqlite3-wasm-wheels. Для собственных Python-приложений автор предлагает ту же связку из WebAssembly и Pyodide как способ делать окружения предпросмотра, демонстрации и воспроизведения багов.

Можно ли доверять

Материал, авторский пост самого Саймона Уиллисона, создателя Datasette Lite, поэтому описание архитектуры и возможностей даёт первоисточник, но оценка «почти неотличим от настоящего серверного приложения», его собственная и независимо не подтверждена. Других сторон (мейнтейнеров Datasette, производителей браузеров) в тексте нет. Цифр по скорости загрузки и потреблению памяти нет, упомянут лишь короткий экран загрузки; браузеры, на которых проверялось решение, не названы. Цифры по версиям SQLite в тексте расходятся без пояснений: в списке возможностей «более 100» версий, в репозитории wheel-пакетов, 163.

Риски и подводные камни

Для работы нужен Pyodide в отдельном веб-воркере: внутри service worker он держит состояние лишь около 30 секунд (зависит от браузера), поэтому в схеме «много движущихся частей», как признаёт автор. Файлы по внешним ссылкам требуют открытых CORS-заголовков. Автор оговаривает, что запускать PostgreSQL или MySQL в WebAssembly возможно, но это малоизведанный путь, так что трюк хорошо ложится на приложения с SQLite. Утверждение, что почти любое Python-приложение может так работать, сформулировано с оговоркой «должно суметь» и не проверено автором на других проектах. Сам автор пишет, что система началась как исследовательский набросок в мае, а уверенно выпустить её удалось лишь в ноябре.

«Почти любое Python-приложение должно суметь провернуть тот же трюк.»

— Саймон Уиллисон, автор Datasette Lite