datasette/tests
Simon Willison ed631e690b
?_labels= and ?_label=COL to expand foreign keys in JSON/CSV
These new querystring arguments can be used to request expanded foreign keys
in both JSON and CSV formats.

?_labels=on turns on expansions for ALL foreign key columns

?_label=COLUMN1&_label=COLUMN2 can be used to pick specific columns to expand

e.g. `Street_Tree_List.json?_label=qSpecies&_label=qLegalStatus`

    {
        "rowid": 233,
        "TreeID": 121240,
        "qLegalStatus": {
            "value" 2,
            "label": "Private"
        }
        "qSpecies": {
            "value": 16,
            "label": "Sycamore"
        }
        "qAddress": "91 Commonwealth Ave",
        ...
    }

The labels option also works for the HTML and CSV views.

HTML defaults to `?_labels=on`, so if you pass `?_labels=off` you can disable
foreign key expansion entirely - or you can use `?_label=COLUMN` to request
just specific columns.

If you expand labels on CSV you get additional columns in the output:

`/Street_Tree_List.csv?_label=qLegalStatus`

    rowid,TreeID,qLegalStatus,qLegalStatus_label...
    1,141565,1,Permitted Site...
    2,232565,2,Undocumented...

I also refactored the existing foreign key expansion code.

Closes #233. Refs #266.
2018-06-16 15:18:57 -07:00
..
__init__.py Broke up test_app into test_api and test_html 2017-12-15 04:08:24 -08:00
fixtures.py Test client wrapper removing need for gather_request - refs #272 2018-06-04 20:53:12 -07:00
test_api.py ?_labels= and ?_label=COL to expand foreign keys in JSON/CSV 2018-06-16 15:18:57 -07:00
test_csv.py ?_labels= and ?_label=COL to expand foreign keys in JSON/CSV 2018-06-16 15:18:57 -07:00
test_docs.py Test that ensures all config options are documented 2018-05-26 15:11:16 -07:00
test_html.py ?_labels= and ?_label=COL to expand foreign keys in JSON/CSV 2018-06-16 15:18:57 -07:00
test_inspect.py Use scope='session' for all fixtures 2018-05-28 13:41:06 -07:00
test_plugins.py Test client wrapper removing need for gather_request - refs #272 2018-06-04 20:53:12 -07:00
test_utils.py Basic CSV export, refs #266 2018-06-14 23:51:23 -07:00