simonw/datasette

Gather feedback on new ?_extra= design

Open

#2,042 建立於 2023年3月22日

在 GitHub 查看
 (0 留言) (0 反應) (0 負責人)Python (8,637 star) (625 fork)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
議題類型
research
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
2
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
under 1 hour
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
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.