simonw/datasette

Gather feedback on new ?_extra= design

Open

#2,042 opened on 2023年3月22日

GitHub で見る
 (0 comments) (0 reactions) (0 assignees)Python (8,637 stars) (625 forks)batch import
help wantedjson-extras

説明

Now that I've landed:

  • #1999

See also:

  • #262

I want to get some feedback from people on the design of the new ?_extra= feature, before freezing it into Datasette 1.0.

The big change is that the default JSON representation is now MUCH slimmer - it only gives you keys for "next" and "rows", where rows is a list of JSON objects (not a list of arrays as was previously the default) - for example https://latest.datasette.io/fixtures/sortable.json

If you want extra stuff you can ask for it with the new ?_extra= parameter - e.g. https://latest.datasette.io/fixtures/sortable.json?_extra=columns&_extra=suggested_facets

You can use ?_extra=extras to see a list of available extras: https://latest.datasette.io/fixtures/sortable.json?_extra=extras

コントリビューターガイド

技術スタック
pythonsqlite
領域
apibackend
Issue 種別
research
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
2
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
under 1 hour
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
fresh
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
clear
前提条件
なし
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
80
調査方針
Test the new ? extra= feature using the provided examples (e.g., https://latest.datasette.io/fixtures/sortable.json? extra=columns). Provide feedback on the design, especially the default slim JSON representation and the extra parameter functionality. Comment on the issue with suggestions or observations. No code changes required.