63 rows where repo = 107914493 sorted by created_at descending

View and edit SQL

Suggested facets: target_commitish, prerelease, created_at (date), published_at (date)

id html_url node_id tag_name target_commitish name draft author prerelease created_at ▲ published_at body repo
31354944 MDc6UmVsZWFzZTMxMzU0OTQ0 0.49.1 main 0.49.1 0 simonw 9599 0 2020-09-15T20:20:15Z 2020-09-15T20:21:16Z
  • Fixed a bug with writable canned queries that use magic parameters but accept no non-magic arguments. (#967)
datasette 107914493
31288240 MDc6UmVsZWFzZTMxMjg4MjQw 0.49 main 0.49 0 simonw 9599 0 2020-09-14T21:38:24Z 2020-09-14T21:40:11Z
  • Writable canned queries now expose a JSON API, see JSON API for writable canned queries. (#880)
  • New mechanism for defining page templates with custom path parameters - a template file called pages/about/{slug}.html will be used to render any requests to /about/something. See Path parameters for pages. (#944)
  • register_output_renderer() render functions can now return a Response. (#953)
  • New --upgrade option for datasette install. (#945)
  • New datasette --pdb option. (#962)
  • datasette --get exit code now reflects the internal HTTP status code. (#947)
  • New raise_404() template function for returning 404 errors. (#964)
  • datasette publish heroku now deploys using Python 3.8.5
  • Upgraded CodeMirror to 5.57.0. (#948)
  • Upgraded code style to Black 20.8b1. (#958)
  • Fixed bug where selected facets were not correctly persisted in hidden form fields on the table page. (#963)
  • Renamed the default error template from 500.html to error.html.
  • Custom error pages are now documented, see Custom error pages. (#965)
datasette 107914493
31227999 MDc6UmVsZWFzZTMxMjI3OTk5 0.49a1 main 0.49a1 0 simonw 9599 1 2020-09-14T02:47:21Z 2020-09-14T02:48:19Z
  • Upgraded CodeMirror to 5.57.0. (#948)
  • Upgraded code style to Black 20.8b1. (#958)
  • New datasette --pdb option. (#962)
  • datasette --get exit code now reflects the internal HTTP status code. (#947)
  • Fixed bug where selected facets were not correctly persisted in hidden form fields on the table page. (#963)
  • New mechanism for defining page templates with custom path parameters. (#944)
datasette 107914493
30353073 MDc6UmVsZWFzZTMwMzUzMDcz 0.49a0 main 0.49a0 0 simonw 9599 1 2020-08-28T23:12:47Z 2020-08-28T23:18:09Z
  • register_output_renderer() render functions can now return a Response. (#953)
  • New --upgrade option for datasette install. (#945)
  • datasette publish heroku now deploys using Python 3.8.5
datasette 107914493
29749566 MDc6UmVsZWFzZTI5NzQ5NTY2 0.48 main 0.48 0 simonw 9599 0 2020-08-16T18:56:31Z 2020-08-16T18:58:34Z datasette 107914493
29738457 MDc6UmVsZWFzZTI5NzM4NDU3 0.47.3 main 0.47.3 0 simonw 9599 0 2020-08-15T20:56:08Z 2020-08-15T21:03:58Z
  • The datasette --get command-line mechanism now ensures any plugins using the startup() hook are correctly executed. (#934)
datasette 107914493
29625082 MDc6UmVsZWFzZTI5NjI1MDgy 0.47.2 main 0.47.2 0 simonw 9599 0 2020-08-12T20:54:33Z 2020-08-12T20:55:28Z datasette 107914493
29587652 MDc6UmVsZWFzZTI5NTg3NjUy 0.47.1 main 0.47.1 0 simonw 9599 0 2020-08-12T02:37:24Z 2020-08-12T02:38:00Z
  • Fixed a bug where the sdist distribution of Datasette was not correctly including the template files. (#930)
datasette 107914493
29585154 MDc6UmVsZWFzZTI5NTg1MTU0 0.47 main 0.47 0 simonw 9599 0 2020-08-12T00:42:47Z 2020-08-12T00:44:52Z
  • Datasette now has a GitHub discussions forum for conversations about the project that go beyond just bug reports and issues.
  • Datasette can now be installed on macOS using Homebrew! Run brew install simonw/datasette/datasette. See Using Homebrew. (#335)
  • Two new commands: datasette install name-of-plugin and datasette uninstall name-of-plugin. These are equivalent to pip install and pip uninstall but automatically run in the same virtual environment as Datasette, so users don't have to figure out where that virtual environment is - useful for installations created using Homebrew or pipx. See Installing plugins. (#925)
  • A new command-line option, datasette --get, accepts a path to a URL within the Datasette instance. It will run that request through Datasette (without starting a web server) and print out the repsonse. See datasette --get for an example. (#926)
datasette 107914493
29489364 MDc6UmVsZWFzZTI5NDg5MzY0 0.46 main 0.46 0 simonw 9599 0 2020-08-09T16:09:07Z 2020-08-09T16:10:47Z

Warning: This release contains a security fix related to authenticated writable canned queries. If you are using this feature you should upgrade as soon as possible.

  • Security fix: CSRF tokens were incorrectly included in read-only canned query forms, which could allow them to be leaked to a sophisticated attacker. See issue 918 for details.
  • Datasette now supports GraphQL via the new datasette-graphql plugin - see GraphQL in Datasette with the new datasette-graphql plugin.
  • Principle git branch has been renamed from master to main. (#849)
  • New debugging tool: /-/allow-debug tool (demo here) helps test allow blocks against actors, as described in Defining permissions with "allow" blocks. (#908)
  • New logo for the documentation, and a new project tagline: "An open source multi-tool for exploring and publishing data".
  • Whitespace in column values is now respected on display, using white-space: pre-wrap. (#896)
  • New await request.post_body() method for accessing the raw POST body, see Request object. (#897)
  • Database file downloads now include a content-length HTTP header, enabling download progress bars. (#905)
  • File downloads now also correctly set the suggested file name using a content-disposition HTTP header. (#909)
  • tests are now excluded from the Datasette package properly - thanks, abeyerpath. (#456)
  • The Datasette package published to PyPI now includes sdist as well as bdist_wheel.
  • Better titles for canned query pages. (#887)
  • Now only loads Python files from a directory passed using the --plugins-dir option - thanks, Amjith Ramanujam. (#890)
  • New documentation section on Publishing to Vercel.
datasette 107914493
28134124 MDc6UmVsZWFzZTI4MTM0MTI0 0.45 master 0.45 0 simonw 9599 0 2020-07-01T21:43:07Z 2020-07-01T21:46:07Z

Magic parameters for canned queries, a log out feature, improved plugin documentation and four new plugin hooks.

Magic parameters for canned queries

Canned queries now support Magic parameters, which can be used to insert or select automatically generated values. For example:

insert into logs
  (user_id, timestamp)
  (:_actor_id, :_now_datetime_utc)

This inserts the currently authenticated actor ID and the current datetime. (#842)

Log out

The ds_actor cookie can be used by plugins (or by Datasette's --root mechanism) to authenticate users. The new /-/logout page provides a way to clear that cookie.

A "Log out" button now shows in the global navigation provided the user is authenticated using the ds_actor cookie. (#840)

Better plugin documentation

The plugin documentation has been re-arranged into four sections, including a brand new section on testing plugins. (#687)

  • Plugins introduces Datasette's plugin system and describes how to install and configure plugins.
  • Writing plugins describes how to author plugins, from simple one-off plugins to packaged plugins that can be published to PyPI. It also describes how to start a plugin using the new datasette-plugin cookiecutter template.
  • Plugin hooks is a full list of detailed documentation for every Datasette plugin hook.
  • Testing plugins describes how to write tests for Datasette plugins, using pytest and HTTPX.

New plugin hooks

Smaller changes

  • Cascading view permissons - so if a user has view-table they can view the table page even if they do not have view-database or view-instance. (#832)
  • CSRF protection no longer applies to Authentication: Bearer token requests or requests without cookies. (#835)
  • datasette.add_message() now works inside plugins. (#864)
  • Workaround for "Too many open files" error in test runs. (#846)
  • Respect existing scope["actor"] if already set by ASGI middleware. (#854)
  • New process for shipping Alpha and beta releases. (#807)
  • {{ csrftoken() }} now works when plugins render a template using datasette.render_template(..., request=request). (#863)
  • Datasette now creates a single Request object and uses it throughout the lifetime of the current HTTP request. (#870)
datasette 107914493
28097766 MDc6UmVsZWFzZTI4MDk3NzY2 0.45a5 master 0.45a5 0 simonw 9599 1 2020-07-01T04:25:35Z 2020-07-01T04:27:08Z datasette 107914493
28008549 MDc6UmVsZWFzZTI4MDA4NTQ5 0.45a4 master 0.45a4 0 simonw 9599 1 2020-06-29T02:31:16Z 2020-06-29T02:33:02Z datasette 107914493
27994774 MDc6UmVsZWFzZTI3OTk0Nzc0 0.45a3 master 0.45a3 0 simonw 9599 1 2020-06-28T03:22:49Z 2020-06-28T03:27:12Z datasette 107914493
27856779 MDc6UmVsZWFzZTI3ODU2Nzc5 0.45a2 master 0.45a2 0 simonw 9599 1 2020-06-24T04:17:30Z 2020-06-24T04:32:12Z datasette 107914493
27707079 MDc6UmVsZWFzZTI3NzA3MDc5 0.45a1 master 0.45a1 0 simonw 9599 1 2020-06-18T23:52:16Z 2020-06-19T00:02:29Z datasette 107914493
27703093 MDc6UmVsZWFzZTI3NzAzMDkz 0.45a0 master 0.45a0 0 simonw 9599 1 2020-06-18T20:58:09Z 2020-06-18T21:14:00Z datasette 107914493
27483276 MDc6UmVsZWFzZTI3NDgzMjc2 0.44 master 0.44 0 simonw 9599 0 2020-06-12T01:19:30Z 2020-06-12T07:10:38Z

Authentication and permissions, writable canned queries, flash messages, new plugin hooks and more. Full release notes. See also Datasette 0.44: the annotated release notes.

datasette 107914493
26994005 MDc6UmVsZWFzZTI2OTk0MDA1 0.43 master 0.43 0 simonw 9599 0 2020-05-28T14:11:06Z 2020-05-28T14:39:18Z

The main focus of this release is a major upgrade to the register_output_renderer(datasette) plugin hook, which allows plugins to provide new output formats for Datasette such as datasette-atom and datasette-ics.

  • Redesign of register_output_renderer(datasette) to provide more context to the render callback and support an optional "can_render" callback that controls if a suggested link to the output format is provided. (#581, #770)
  • Visually distinguish float and integer columns - useful for figuring out why order-by-column might be returning unexpected results. (#729)
  • The Request object, which is passed to several plugin hooks, is now documented. (#706)
  • New metadata.json option for setting a custom default page size for specific tables and views, see Setting a custom page size. (#751)
  • Canned queries can now be configured with a default URL fragment hash, useful when working with plugins such as datasette-vega, see Setting a default fragment. (#706)
  • Fixed a bug in datasette publish when running on operating systems where the /tmp directory lives in a different volume, using a backport of the Python 3.8 shutil.copytree() function. (#744)
  • Every plugin hook is now covered by the unit tests, and a new unit test checks that each plugin hook has at least one corresponding test. (#771, #773)
datasette 107914493
26320774 MDc6UmVsZWFzZTI2MzIwNzc0 0.42 master 0.42 0 simonw 9599 0 2020-05-08T17:38:27Z 2020-05-08T17:56:36Z

A small release which provides improved internal methods for use in plugins, along with documentation. See #685.

  • Added documentation for db.execute(), see await db.execute(sql, ...).
  • Renamed db.execute_against_connection_in_thread() to db.execute_fn() and made it a documented method, see await db.execute_fn(fn).
  • New results.first() and results.single_value() methods, plus documentation for the Results class - see Results.
datasette 107914493
26240662 MDc6UmVsZWFzZTI2MjQwNjYy 0.41 master 0.41 0 simonw 9599 0 2020-05-06T18:20:58Z 2020-05-06T18:30:03Z

You can now create custom pages within your Datasette instance using a custom template file. For example, adding a template file called templates/pages/about.html will result in a new page being served at /about on your instance. See the custom pages documentation for full details, including how to return custom HTTP headers, redirects and status codes. (#648)

Configuration directory mode (#731) allows you to define a custom Datasette instance as a directory. So instead of running the following:

$ datasette one.db two.db \
  --metadata.json \
  --template-dir=templates/ \
  --plugins-dir=plugins \
  --static css:css

You can instead arrange your files in a single directory called my-project and run this:

$ datasette my-project/

Also in this release:

  • New NOT LIKE table filter: ?colname__notlike=expression. (#750)
  • Datasette now has a pattern portfolio at /-/patterns - e.g. This is a page that shows every Datasette user interface component in one place, to aid core development and people building custom CSS themes. (#151)
  • SQLite PRAGMA functions such as pragma_table_info(tablename) are now allowed in Datasette SQL queries. (#761)
  • Datasette pages now consistently return a content-type of text/html; charset=utf-8". (#752)
  • Datasette now handles an ASGI raw_path value of None, which should allow compatibilty with the Mangum adapter for running ASGI apps on AWS Lambda. Thanks, Colin Dellow. (#719)
  • Installation documentation now covers how to Install using pipx. (#756)
  • Improved the documentation for Full-text search.
datasette 107914493
25748264 MDc6UmVsZWFzZTI1NzQ4MjY0 0.40 master 0.40 0 simonw 9599 0 2020-04-22T04:06:39Z 2020-04-22T04:06:51Z
  • Datasette Metadata can now be provided as a YAML file as an optional alternative to JSON. See Using YAML for metadata. (#713)
  • Removed support for datasette publish now, which used the the now-retired Zeit Now v1 hosting platform. A new plugin, datasette-publish-now, can be installed to publish data to Zeit (now Vercel) Now v2. (#710)
  • Fixed a bug where the extra_template_vars(request, view_name) plugin hook was not receiving the correct view_name. (#716)
  • Variables added to the template context by the extra_template_vars() plugin hook are now shown in the ?_context=1 debugging mode (see template_debug). (#693)
  • Fixed a bug where the “templates considered” HTML comment was no longer being displayed. (#689)
  • Fixed a datasette publish bug where --plugin-secret would over-ride plugin configuration in the provided metadata.json file. (#724)
  • Added a new CSS class for customizing the canned query page. (#727)
datasette 107914493
24836140 MDc6UmVsZWFzZTI0ODM2MTQw 0.39 master 0.39 0 simonw 9599 0 2020-03-25T04:02:37Z 2020-03-25T04:11:35Z
  • New base_url configuration setting for serving up the correct links while running Datasette under a different URL prefix. (#394)
  • New metadata settings "sort" and "sort_desc" for setting the default sort order for a table. See Setting a default sort order. (#702)
  • Sort direction arrow now displays by default on the primary key. This means you only have to click once (not twice) to sort in reverse order. (#677)
  • New await Request(scope, receive).post_vars() method for accessing POST form variables. (#700)
  • Plugin hooks documentation now links to example uses of each plugin. (#709)
datasette 107914493
24330942 MDc6UmVsZWFzZTI0MzMwOTQy 0.38 master 0.38 0 simonw 9599 0 2020-03-08T23:26:50Z 2020-03-08T23:42:36Z
  • The Docker build of Datasette now uses SQLite 3.31.1, upgraded from 3.26. (#695)
  • datasette publish cloudrun now accepts an optional --memory=2Gi flag for setting the Cloud Run allocated memory to a value other than the default (256Mi). (#694)
  • Fixed bug where templates that shipped with plugins were sometimes not being correctly loaded. (#697)
datasette 107914493
24154697 MDc6UmVsZWFzZTI0MTU0Njk3 0.37.1 master Datasette 0.37.1 0 simonw 9599 0 2020-03-03T03:43:08Z 2020-03-03T03:46:17Z datasette 107914493
23986460 MDc6UmVsZWFzZTIzOTg2NDYw 0.37 master Datasette 0.37 0 simonw 9599 0 2020-02-26T01:22:02Z 2020-02-26T03:44:07Z
  • Plugins now have a supported mechanism for writing to a database, using the new .execute_write() and .execute_write_fn() methods. Documentation. (#682)
  • Immutable databases that have had their rows counted using the inspect command now use the calculated count more effectively - thanks, Kevin Keogh. (#666)
  • --reload no longer restarts the server if a database file is modified, unless that database was opened immutable mode with -i. (#494)
  • New ?_searchmode=raw option turns off escaping for FTS queries in ?_search= allowing full use of SQLite’s FTS5 query syntax. (#676)
datasette 107914493
23896184 MDc6UmVsZWFzZTIzODk2MTg0 0.36 master Datasette 0.36 0 simonw 9599 0 2020-02-22T03:04:46Z 2020-02-22T03:24:50Z

datasette 107914493
23395622 MDc6UmVsZWFzZTIzMzk1NjIy 0.35 master Datasette 0.35 0 simonw 9599 0 2020-02-05T02:17:47Z 2020-02-05T02:32:34Z
  • Added five new plugins and one new conversion tool to the The Datasette Ecosystem.
  • The Datasette class has a new render_template() method which can be used by plugins to render templates using Datasette’s pre-configured Jinja templating library.
  • You can now execute SQL queries that start with a -- comment - thanks, Jay Graves (#653)

datasette 107914493
23239304 MDc6UmVsZWFzZTIzMjM5MzA0 0.34 master Datasette 0.34 0 simonw 9599 0 2020-01-30T00:09:01Z 2020-01-30T00:29:21Z
  • _search= queries are now correctly escaped using a new escape_fts() custom SQL function. This means you can now run searches for strings like park. without seeing errors. (#651)
  • Google Cloud Run is no longer in beta, so datasette publish cloudrun has been updated to work even if the user has not installed the gcloud beta components package. Thanks, Katie McLaughlin (#660)
  • datasette package now accepts a --port option for specifying which port the resulting Docker container should listen on. (#661)

datasette 107914493
22415542 MDc6UmVsZWFzZTIyNDE1NTQy 0.33 master Datasette 0.33 0 simonw 9599 0 2019-12-22T16:27:04Z 2019-12-22T16:43:31Z
  • rowid is now included in dropdown menus for filtering tables (#636)
  • Columns are now only suggested for faceting if they have at least one value with more than one record (#638)
  • Queries with no results now display “0 results” (#637)
  • Improved documentation for the --static option (#641)
  • asyncio task information is now included on the /-/threads debug page
  • Bumped Uvicorn dependency 0.11
  • You can now use --port 0 to listen on an available port
  • New template_debug setting for debugging templates, e.g. (#654)

datasette 107914493
21492068 MDc6UmVsZWFzZTIxNDkyMDY4 0.32 master Datasette 0.32 0 simonw 9599 0 2019-11-14T23:20:21Z 2019-11-14T23:42:14Z

Datasette now renders templates using Jinja async mode. This makes it easy for plugins to provide custom template functions that perform asynchronous actions, for example the new datasette-template-sql plugin which allows custom templates to directly execute SQL queries and render their results. (#628)

datasette 107914493
21449006 MDc6UmVsZWFzZTIxNDQ5MDA2 0.31.2 master 0.31.2 0 simonw 9599 0 2019-11-13T16:48:36Z 2019-11-13T17:38:59Z
  • Fixed a bug where datasette publish heroku applications failed to start (#633)
  • Fix for datasette publish with just --source_url - thanks, Stanley Zheng (#572)
  • Deployments to Heroku now use Python 3.8.0 (#632)

datasette 107914493
21426299 MDc6UmVsZWFzZTIxNDI2Mjk5 0.31.1 master 0.31.1 0 simonw 9599 0 2019-11-13T02:18:39Z 2019-11-13T02:40:53Z
  • Deployments created using datasette publish now use python:3.8 base Docker image (#629)

datasette 107914493
21426008 MDc6UmVsZWFzZTIxNDI2MDA4 0.31 master Datasette 0.31 0 simonw 9599 0 2019-11-12T05:33:51Z 2019-11-13T02:16:15Z

This version adds compatibility with Python 3.8 and breaks compatibility with Python 3.5.

Full release notes:

datasette 107914493
21169835 MDc6UmVsZWFzZTIxMTY5ODM1 0.30.2 master 0.30.2 0 simonw 9599 0 2019-11-02T23:12:46Z 2019-11-02T23:33:13Z

datasette 107914493
21162064 MDc6UmVsZWFzZTIxMTYyMDY0 0.30.1 master 0.30.1 0 simonw 9599 0 2019-10-30T19:00:21Z 2019-11-02T00:06:02Z

datasette 107914493
21098052 MDc6UmVsZWFzZTIxMDk4MDUy 0.30 master 0.30 0 simonw 9599 0 2019-10-19T01:08:04Z 2019-10-30T18:51:30Z

datasette 107914493
20795250 MDc6UmVsZWFzZTIwNzk1MjUw 0.29.3 master 0.29.3 0 simonw 9599 0 2019-09-03T00:40:53Z 2019-10-18T05:24:54Z

datasette 107914493
19704661 MDc6UmVsZWFzZTE5NzA0NjYx 0.29.2 master 0.29.2 0 simonw 9599 0 2019-07-14T03:04:05Z 2019-09-03T00:33:35Z
  • Bumped Uvicorn to 0.8.4, fixing a bug where the querystring was not included in the server logs. (#559)
  • Fixed bug where the navigation breadcrumbs were not displayed correctly on the page for a custom query. (#558)
  • Fixed bug where custom query names containing unicode characters caused errors.

datasette 107914493
18598489 MDc6UmVsZWFzZTE4NTk4NDg5 0.29.1 master 0.29.1 0 simonw 9599 0 2019-07-11T16:17:55Z 2019-07-14T01:43:44Z
  • Fixed bug with static mounts using relative paths which could lead to traversal exploits (#555) - thanks Abdussamet Kocak!

datasette 107914493
18461320 MDc6UmVsZWFzZTE4NDYxMzIw 0.29 master Datasette 0.29 0 simonw 9599 0 2019-07-08T03:14:27Z 2019-07-08T03:43:13Z

ASGI, new plugin hooks, facet by date and much, much more… See the release notes for full details.

datasette 107914493
17450414 MDc6UmVsZWFzZTE3NDUwNDE0 0.28 master Datasette 0.28 0 simonw 9599 0 2019-05-19T21:37:49Z 2019-05-19T21:42:28Z

Datasette 0.28 - a salmagundi of new features!
* No longer immutable! Datasette now supports databases that change.
* Faceting improvements including facet-by-JSON-array and the ability to define custom faceting using plugins.
* datasette publish cloudrun lets you publish databasese to Google's new Cloud Run hosting service.
* New register_output_renderer plugin hook for adding custom output extensions to Datasette in addition to the default .json and .csv.
* Dozens of other smaller features and tweaks - see the release notes for full details.

datasette 107914493
15389392 MDc6UmVsZWFzZTE1Mzg5Mzky 0.27 master Datasette 0.27 0 simonw 9599 0 2019-02-01T03:47:05Z 2019-02-06T05:10:20Z

datasette 107914493
15206659 MDc6UmVsZWFzZTE1MjA2NjU5 0.26.1 master Datasette 0.26.1 0 simonw 9599 0 2019-01-11T00:51:38Z 2019-01-28T01:50:45Z

Release notes:

datasette 107914493
14914779 MDc6UmVsZWFzZTE0OTE0Nzc5 0.26 master Datasette 0.26 0 simonw 9599 0 2019-01-03T02:53:59Z 2019-01-10T21:41:00Z

Datasette 0.26 release notes

datasette 107914493
14560304 MDc6UmVsZWFzZTE0NTYwMzA0 0.25.2 master Datasette 0.25.2 0 simonw 9599 0 2018-12-16T21:26:37Z 2018-12-16T21:45:39Z datasette 107914493
14560294 MDc6UmVsZWFzZTE0NTYwMjk0 0.25.1 master Datasette 0.25.1 0 simonw 9599 0 2018-11-05T06:31:41Z 2018-12-16T21:44:27Z

Documentation improvements plus a fix for publishing to Zeit Now.

  • datasette publish now now uses Zeit’s v1 platform, to work around the new 100MB image limit. Thanks, @slygent - closes #366.
datasette 107914493
12986637 MDc6UmVsZWFzZTEyOTg2NjM3 0.25 master Datasette 0.25 0 simonw 9599 0 2018-09-19T17:48:12Z 2018-09-19T18:27:21Z

New plugin hooks, improved database view support and an easier way to use more recent versions of SQLite.

See full release notes here:

datasette 107914493
12080036 MDc6UmVsZWFzZTEyMDgwMDM2 0.24 main Datasette 0.24 0 simonw 9599 0 2018-07-24T04:34:38Z 2018-07-24T16:51:29Z

See full release notes here:

datasette 107914493
11825600 MDc6UmVsZWFzZTExODI1NjAw 0.23.2 main Datasette 0.23.2 0 simonw 9599 0 2018-07-08T05:28:45Z 2018-07-08T05:41:38Z

Minor bugfix and documentation release.

  • CSV export now respects --cors, fixes #326
  • Installation instructions including docker image - closes #328
  • Fix for row pages for tables with / in, closes #325
datasette 107914493
11591352 MDc6UmVsZWFzZTExNTkxMzUy 0.23.1 main Datasette 0.23.1 0 simonw 9599 0 2018-06-21T15:37:13Z 2018-06-21T16:02:44Z

Minor bugfix release.

  • Correctly display empty strings in HTML table, closes #314
  • Allow “.” in database filenames, closes #302
  • 404s ending in slash redirect to remove that slash, closes #309
  • Fixed incorrect display of compound primary keys with foreign key references. Closes #319
  • Docs + example of canned SQL query using || concatenation. Closes #321
  • Correctly display facets with value of 0 - closes #318
  • Default ‘expand labels’ to checked in CSV advanced export
datasette 107914493
11530498 MDc6UmVsZWFzZTExNTMwNDk4 0.23 main Datasette 0.23: CSV, SpatiaLite and more 0 simonw 9599 0 2018-06-18T15:11:57Z 2018-06-18T15:28:37Z

This release features CSV export, improved options for foreign key expansions, new configuration settings and improved support for SpatiaLite.

See full release notes here:

datasette 107914493
11136605 MDc6UmVsZWFzZTExMTM2NjA1 0.22.1 main Datasette 0.22.1 0 simonw 9599 0 2018-05-23T14:00:01Z 2018-05-23T14:04:17Z

Bugfix release, plus we now use versioneer for our version numbers.

  • Faceting no longer breaks pagination, fixes #282
  • Add __version_info__ derived from __version__ [Robert Gieseke]

This might be tuple of more than two values (major and minor
version) if commits have been made after a release.
- Add version number support with Versioneer. [Robert Gieseke]

Versioneer Licence:
Public Domain (CC0-1.0)

Closes #273
- Refactor inspect logic [Russ Garrett]

datasette 107914493
11087850 MDc6UmVsZWFzZTExMDg3ODUw 0.22 main Datasette 0.22: Datasette Facets 0 simonw 9599 0 2018-05-20T23:41:47Z 2018-05-20T23:44:19Z

The big new feature in this release is facets. Datasette can now apply faceted browse to any column in any table. It will also suggest possible facets. See the Datasette Facets announcement post for more details.

In addition to the work on facets:

Removed the --page_size= argument to datasette serve in favour of:

  datasette serve --config default_page_size:50 mydb.db

Added new help section:

  $ datasette --help-config
  Config options:
    default_page_size            Default page size for the table view
    max_returned_rows            Maximum rows that can be returned from a table
                                 or custom query (default=1000)
    sql_time_limit_ms            Time limit for a SQL query in milliseconds
    default_facet_size           Number of values to return for requested facets
    facet_time_limit_ms          Time limit for calculating a requested facet
    facet_suggest_time_limit_ms  Time limit for calculating a suggested facet
  • Only apply responsive table styles to .rows-and-column

Otherwise they interfere with tables in the description, e.g. on

datasette 107914493
10868113 MDc6UmVsZWFzZTEwODY4MTEz 0.21 main Datasette 0.21: New _shape=, new _size=, search within columns 0 simonw 9599 0 2018-05-05T23:15:38Z 2018-05-05T23:21:33Z

New JSON _shape= options, the ability to set table _size= and a mechanism for searching within specific columns.

  • Default tests to using a longer timelimit

    Every now and then a test will fail in Travis CI on Python 3.5 because it hit the default 20ms SQL time limit.

    Test fixtures now default to a 200ms time limit, and we only use the 20ms time limit for the specific test that tests query interruption.

    This should make our tests on Python 3.5 in Travis much more stable.

  • Support _search_COLUMN=text searches, closes #237

  • Show version on /-/plugins page, closes #248

  • ?_size=max option, closes #249

  • Added /-/versions and /-/versions.json, closes #244

    Sample output:

      "python": {
        "version": "3.6.3",
        "full": "3.6.3 (default, Oct  4 2017, 06:09:38) \n[GCC 4.2.1 Compatible Apple LLVM 9.0.0 (clang-900.0.37)]"
      "datasette": {
        "version": "0.20"
      "sqlite": {
        "version": "3.23.1",
        "extensions": {
          "json1": null,
          "spatialite": "4.3.0a"
  • Renamed ?_sql_time_limit_ms= to ?_timelimit, closes #242

  • New ?_shape=array option + tweaks to _shape, closes #245

    • Default is now ?_shape=arrays (renamed from lists)
    • New ?_shape=array returns an array of objects as the root object
    • Changed ?_shape=object to return the object as the root
    • Updated docs
  • FTS tables now detected by inspect(), closes #240

  • New ?_size=XXX querystring parameter for table view, closes #229

    Also added documentation for all of the _special arguments.

    Plus deleted some duplicate logic implementing _group_count.

  • If max_returned_rows==page_size, increment max_returned_rows - fixes #230

  • New hidden: True option for table metadata, closes #239

  • Hide idx_* tables if spatialite detected, closes #228

  • Added class=rows-and-columns to custom query results table

  • Added CSS class rows-and-columns to main table

  • label_column option in metadata.json - closes #234

datasette 107914493
10645022 MDc6UmVsZWFzZTEwNjQ1MDIy 0.20 main Datasette 0.20: static assets and templates for plugins 0 simonw 9599 0 2018-04-20T14:36:29Z 2018-04-20T14:41:14Z

Mostly new work on the Plugins mechanism: plugins can now bundle static assets and custom templates, and datasette publish has a new --install=name-of-plugin option.

  • Add col-X classes to HTML table on custom query page
  • Fixed out-dated template in documentation
  • Plugins can now bundle custom templates, #224
  • Added /-/metadata /-/plugins /-/inspect, #225
  • Documentation for --install option, refs #223
  • Datasette publish/package --install option, #223
  • Fix for plugins in Python 3.5, #222
  • New plugin hooks: extra_css_urls() and extra_js_urls(), #214
  • /-/static-plugins/PLUGIN_NAME/ now serves static/ from plugins
  • <th> now gets class="col-X" - plus added col-X documentation
  • Use to_css_class for table cell column classes

This ensures that columns with spaces in the name will still
generate usable CSS class names. Refs #209
- Add column name classes to <td>s, make PK bold [Russ Garrett]
- Don't duplicate simple primary keys in the link column [Russ Garrett]

When there's a simple (single-column) primary key, it looks weird to
duplicate it in the link column.

This change removes the second PK column and treats the link column as
if it were the PK column from a header/sorting perspective.
- Correct escaping for HTML display of row links [Russ Garrett]
- Longer time limit for test_paginate_compound_keys

It was failing intermittently in Travis - see #209
- Use application/octet-stream for downloadable databses
- Updated PyPI classifiers
- Updated PyPI link to

datasette 107914493
10575542 MDc6UmVsZWFzZTEwNTc1NTQy 0.19 main Datasette 0.19: plugins preview 0 simonw 9599 0 2018-04-17T02:12:21Z 2018-04-17T02:21:51Z

This is the first preview of the new Datasette plugins mechanism. Only two plugin hooks are available so far - for custom SQL functions and custom template filters. There's plenty more to come - read the documentation and get involved in the tracking ticket if you have feedback on the direction so far.

  • Fix for _sort_desc=sortable_with_nulls test, refs #216

  • Fixed #216 - paginate correctly when sorting by nullable column

  • Initial documentation for plugins, closes #213

  • New --plugins-dir=plugins/ option (#212)

New option causing Datasette to load and evaluate all of the Python files in the specified directory and register any plugins that are defined in those files.

This new option is available for the following commands:

  datasette serve mydb.db --plugins-dir=plugins/
  datasette publish now/heroku mydb.db --plugins-dir=plugins/
  datasette package mydb.db --plugins-dir=plugins/
  • Start of the plugin system, based on pluggy (#210)

Uses originally created for the py.test project

We're starting with two plugin hooks:


This is called when a new SQLite connection is created. It can be used to register custom SQL functions.


This is called with the Jinja2 environment. It can be used to register custom template tags and filters.

An example plugin which uses these two hooks can be found at or installed using pip install datasette-plugin-demos

Refs #14

  • Return HTTP 405 on InvalidUsage rather than 500. [Russ Garrett]

This also stops it filling up the logs. This happens for HEAD requests at the moment - which perhaps should be handled better, but that's a different issue.

datasette 107914493
10547491 MDc6UmVsZWFzZTEwNTQ3NDkx 0.18 main Datasette 0.18: units 0 simonw 9599 0 2018-04-14T15:36:10Z 2018-04-14T15:45:11Z

This release introduces support for units, contributed by Russ Garrett (#203). You can now optionally specify the units for specific columns using metadata.json. Once specified, units will be displayed in the HTML view of your table. They also become available for use in filters - if a column is configured with a unit of distance, you can request all rows where that column is less than 50 meters or more than 20 feet for example.

  • Link foreign keys which don't have labels. [Russ Garrett]

    This renders unlabeled FKs as simple links.

    Also includes bonus fixes for two minor issues:

    • In foreign key link hrefs the primary key was escaped using HTML escaping rather than URL escaping. This broke some non-integer PKs.
    • Print tracebacks to console when handling 500 errors.
  • Fix SQLite error when loading rows with no incoming FKs. [Russ Garrett]

    This fixes ERROR: conn=<sqlite3.Connection object at 0x10bbb9f10>, sql = 'select ', params = {'id': '1'} caused by an invalid query when loading incoming FKs.

    The error was ignored due to async but it still got printed to the console.

  • Allow custom units to be registered with Pint. [Russ Garrett]

  • Support units in filters. [Russ Garrett]

  • Tidy up units support. [Russ Garrett]

    • Add units to exported JSON
    • Units key in metadata skeleton
    • Docs
  • Initial units support. [Russ Garrett]

    Add support for specifying units for a column in metadata.json and rendering them on display using pint

datasette 107914493
10542772 MDc6UmVsZWFzZTEwNTQyNzcy 0.16 main Datasette 0.16: sort on mobile, better error handling 0 simonw 9599 0 2018-04-13T18:28:55Z 2018-04-13T21:10:53Z
  • Better mechanism for handling errors; 404s for missing table/database

    New error mechanism closes #193

    404s for missing tables/databases closes #184

  • long_description in markdown for the new PyPI

  • Hide Spatialite system tables. [Russ Garrett]

  • Allow explain select / explain query plan select #201

  • Datasette inspect now finds primary_keys #195

  • Ability to sort using form fields (for mobile portrait mode) #199

    We now display sort options as a select box plus a descending checkbox, which means you can apply sort orders even in portrait mode on a mobile phone where the column headers are hidden.

datasette 107914493
10458641 MDc6UmVsZWFzZTEwNDU4NjQx 0.15 main Datasette 0.15: sort by column 0 simonw 9599 0 2018-04-09T15:48:24Z 2018-04-09T15:55:29Z

The biggest new feature in this release is the ability to sort by column. On the table page the column headers can now be clicked to apply sort (or descending sort), or you can specify ?_sort=column or ?_sort_desc=column directly in the URL.

You can try this feature out on this fivethirtyeight data about the ages of different US politicians.

  • table_rows => table_rows_count, filtered_table_rows => filtered_table_rows_count

    Renamed properties. Closes #194

  • New sortable_columns option in metadata.json to control sort options.

    You can now explicitly set which columns in a table can be used for sorting using the _sort and _sort_desc arguments using metadata.json:

        "databases": {
            "database1": {
                "tables": {
                    "example_table": {
                        "sortable_columns": [

    Refs #189

  • Column headers now link to sort/desc sort - refs #189

  • _sort and _sort_desc parameters for table views

    Allows for paginated sorted results based on a specified column.

    Refs #189

  • Total row count now correct even if _next applied

  • Use .custom_sql() for _group_count implementation (refs #150)

  • Make HTML title more readable in query template (#180) [Ryan Pitts]

  • New ?_shape=objects/object/lists param for JSON API (#192)

    New _shape= parameter replacing old .jsono extension

    Now instead of this:


    We use the _shape parameter like this:


    Also introduced a new _shape called object which looks like this:


    Returning an object for the rows key:

    "rows": {
        "pk1": {
        "pk2": {

    Refs #122

  • Utility for writing test database fixtures to a .db file

    python tests/ /tmp/hello.db

    This is useful for making a SQLite database of the test fixtures for interactive exploration.

  • Compound primary key _next= now plays well with extra filters

    Closes #190

  • Fixed bug with keyset pagination over compound primary keys

    Refs #190

  • Database/Table views inherit source/license/source_url/license_url metadata

    If you set the source_url/license_url/source/license fields in your root metadata those values will now be inherited all the way down to the database and table templates.

    The title/description are NOT inherited.

    Also added unit tests for the HTML generated by the metadata.

    Refs #185

  • Add metadata, if it exists, to heroku temp dir (#178) [Tony Hirst]

  • Initial documentation for pagination

  • Broke up test_app into test_api and test_html

  • Fixed bug with .json path regular expression

    I had a table called geojson and it caused an exception because the regex was matching .json and not \.json

  • Deploy to Heroku with Python 3.6.3

datasette 107914493
8841695 MDc6UmVsZWFzZTg4NDE2OTU= 0.14 main Datasette 0.14: customization edition 0 simonw 9599 0 2017-12-10T01:33:24Z 2017-12-10T01:41:14Z

The theme of this release is customization: Datasette now allows every aspect of its presentation to be customized either using additional CSS or by providing entirely new templates.

Datasette's metadata.json format has also been expanded, to allow per-database and per-table metadata. A new datasette skeleton command can be used to generate a skeleton JSON file ready to be filled in with per-database and per-table details.

The metadata.json file can also be used to define canned queries, as a more powerful alternative to SQL views.

  • extra_css_urls/extra_js_urls in metadata

    A mechanism in the metadata.json format for adding custom CSS and JS urls.

    Create a metadata.json file that looks like this:

        "extra_css_urls": [
        "extra_js_urls": [

    Then start datasette like this:

    datasette mydb.db --metadata=metadata.json

    The CSS and JavaScript files will be linked in the <head> of every page.

    You can also specify a SRI (subresource integrity hash) for these assets:

        "extra_css_urls": [
                "url": "",
                "sri": "sha384-9qIZekWUyjCyDIf2YK1FRoKiPJq4PHt6tp/ulnuuyRBvazd0hG7pWbE99zvwSznI"
        "extra_js_urls": [
                "url": "",
                "sri": "sha256-k2WSCIexGzOj3Euiig+TlR8gA0EmPjuc79OEeY5L45g="

    Modern browsers will only execute the stylesheet or JavaScript if the SRI hash matches the content served. You can generate hashes using

  • Auto-link column values that look like URLs (#153)

  • CSS styling hooks as classes on the body (#153)

    Every template now gets CSS classes in the body designed to support custom styling.

    The index template (the top level page at /) gets this:

    <body class="index">

    The database template (/dbname/) gets this:

    <body class="db db-dbname">

    The table template (/dbname/tablename) gets:

    <body class="table db-dbname table-tablename">

    The row template (/dbname/tablename/rowid) gets:

    <body class="row db-dbname table-tablename">

    The db-x and table-x classes use the database or table names themselves IF they are valid CSS identifiers. If they aren't, we strip any invalid characters out and append a 6 character md5 digest of the original name, in order to ensure that multiple tables which resolve to the same stripped character version still have different CSS classes.

    Some examples (extracted from the unit tests):

    "simple" => "simple"
    "MixedCase" => "MixedCase"
    "-no-leading-hyphens" => "no-leading-hyphens-65bea6"
    "_no-leading-underscores" => "no-leading-underscores-b921bc"
    "no spaces" => "no-spaces-7088d7"
    "-" => "336d5e"
    "no $ characters" => "no--characters-59e024"
  • datasette --template-dir=mytemplates/ argument

    You can now pass an additional argument specifying a directory to look for custom templates in.

    Datasette will fall back on the default templates if a template is not found in that directory.

  • Ability to over-ride templates for individual tables/databases.

    It is now possible to over-ride templates on a per-database / per-row or per-table basis.

    When you access e.g. /mydatabase/mytable Datasette will look for the following:

    - table-mydatabase-mytable.html
    - table.html

    If you provided a --template-dir argument to datasette serve it will look in that directory first.

    The lookup rules are as follows:

    Index page (/):
    Database page (/mydatabase):
    Table page (/mydatabase/mytable):
    Row page (/mydatabase/mytable/id):

    If a table name has spaces or other unexpected characters in it, the template filename will follow the same rules as our custom <body> CSS classes - for example, a table called "Food Trucks" will attempt to load the following templates:


    It is possible to extend the default templates using Jinja template inheritance. If you want to customize EVERY row template with some additional content you can do so by creating a row.html template like this:

    {% extends "default:row.html" %}
    {% block content %}
    <p>This line renders the original block:</p>
    {{ super() }}
    {% endblock %}
  • --static option for datasette serve (#160)

    You can now tell Datasette to serve static files from a specific location at a specific mountpoint.

    For example:

    datasette serve mydb.db --static extra-css:/tmp/static/css

    Now if you visit this URL:


    The following file will be served:

  • Canned query support.

    Named canned queries can now be defined in metadata.json like this:

        "databases": {
            "timezones": {
                "queries": {
                    "timezone_for_point": "select tzid from timezones ..."

    These will be shown in a new "Queries" section beneath "Views" on the database page.

  • New datasette skeleton command for generating metadata.json (#164)

  • metadata.json support for per-table/per-database metadata (#165)

    Also added support for descriptions and HTML descriptions.

    Here's an example metadata.json file illustrating custom per-database and per-table metadata:

        "title": "Overall datasette title",
        "description_html": "This is a <em>description with HTML</em>.",
        "databases": {
            "db1": {
                "title": "First database",
                "description": "This is a string description & has no HTML",
                "license_url": "",
            "license": "The example license",
                "queries": {
                  "canned_query": "select * from table1 limit 3;"
                "tables": {
                    "table1": {
                        "title": "Custom title for table1",
                        "description": "Tables can have descriptions too",
                        "source": "This has a custom source",
                        "source_url": ""
  • Renamed datasette build command to datasette inspect (#130)

  • Upgrade to Sanic 0.7.0 (#168)

  • Package and publish commands now accept --static and --template-dir

    Example usage:

    datasette package --static css:extra-css/ --static js:extra-js/ \
      sf-trees.db --template-dir templates/ --tag sf-trees --branch master

    This creates a local Docker image that includes copies of the templates/, extra-css/ and extra-js/ directories. You can then run it like this:

    docker run -p 8001:8001 sf-trees

    For publishing to Zeit now:

    datasette publish now --static css:extra-css/ --static js:extra-js/ \
      sf-trees.db --template-dir templates/ --name sf-trees --branch master
  • HTML comment showing which templates were considered for a page (#171)

datasette 107914493
8652546 MDc6UmVsZWFzZTg2NTI1NDY= 0.13 main Datasette 0.13: foreign key, search and filters 0 simonw 9599 0 2017-11-25T03:33:39Z 2017-11-25T03:44:46Z

0.13 (2017-11-24)

  • Search now applies to current filters.

    Combined search into the same form as filters.

    Closes #133

  • Much tidier design for table view header.

    Closes #147

  • Added ?column__not=blah filter.

    Closes #148

  • Row page now resolves foreign keys.

    Closes #132

  • Further tweaks to select/input filter styling.

    Refs #86 - thanks for the help, @natbat!

  • Show linked foreign key in table cells.

  • Added UI for editing table filters.

    Refs #86

  • Hide FTS-created tables on index pages.

    Closes #129

  • Add publish to heroku support [Jacob Kaplan-Moss]

    datasette publish heroku mydb.db

    Pull request #104

  • Initial implementation of ?_group_count=column.

    URL shortcut for counting rows grouped by one or more columns.

    ?_group_count=column1&_group_count=column2 works as well.

    SQL generated looks like this:

    select "qSpecies", count(*) as "count"
    from Street_Tree_List
    group by "qSpecies"
    order by "count" desc limit 100

    Or for two columns like this:

    select "qSpecies", "qSiteInfo", count(*) as "count"
    from Street_Tree_List
    group by "qSpecies", "qSiteInfo"
    order by "count" desc limit 100

    Refs #44

  • Added --build=master option to datasette publish and package.

    The datasette publish and datasette package commands both now
    accept an optional --build argument. If provided, this can be used
    to specify a branch published to GitHub that should be built into
    the container.

    This makes it easier to test code that has not yet been officially
    released to PyPI, e.g.:

    datasette publish now mydb.db --branch=master
  • Implemented ?_search=XXX + UI if a FTS table is detected.

    Closes #131

  • Added datasette --version support.

  • Table views now show expanded foreign key references, if possible.

    If a table has foreign key columns, and those foreign key tables
    have label_columns, the TableView will now query those other
    tables for the corresponding values and display those values as
    links in the corresponding table cells.

    label_columns are currently detected by the inspect() function,
    which looks for any table that has just two columns - an ID column
    and one other - and sets the label_column to be that second non-ID

  • Don't prevent tabbing to "Run SQL" button (#117) [Robert

    See comment in #115

  • Add keyboard shortcut to execute SQL query (#115) [Robert

  • Allow --load-extension to be set via environment variable.

  • Add support for ?field__isnull=1 (#107) [Ray N]

  • Add spatialite, switch to debian and local build (#114) [Ariel

  • Added --load-extension argument to datasette serve.

    Allows loading of SQLite extensions. Refs #110.

datasette 107914493
8546575 MDc6UmVsZWFzZTg1NDY1NzU= 0.12 main Datasette 0.12 0 simonw 9599 0 2017-11-16T15:37:46Z 2017-11-16T16:01:35Z
  • Added __version__, now displayed as tooltip in page footer
  • Added initial docs, including a changelog (#99).
  • Turned on auto-escaping in Jinja.
  • Added a UI for editing named parameters (#96).

    You can now construct a custom SQL statement using SQLite named parameters (e.g. :name) and datasette will display form fields for editing those parameters. Here's an example which lets you see the most popular names for dogs of different species registered through various dog registration schemes in Australia.
    - Pin to specific Jinja version. (#100).
    - Default to not (#98).
    - Added extra metadata options to publish and package commands.

    You can now run these commands like so:

    datasette now publish mydb.db \
        --title="My Title" \
        --source="Source" \
        --source_url="" \
        --license="CC0" \

    This will write those values into the metadata.json that is packaged
    with the app. If you also pass --metadata=metadata.json that file
    will be updated with the extra values before being written into the
    Docker image.

  • Added simple production-ready Dockerfile (#94) [Andrew Cutler]

  • New ?_sql_time_limit_ms=10 argument to database and table page
  • SQL syntax highlighting with Codemirror (#89) [Tom Dyson]
datasette 107914493

Advanced export

JSON shape: default, array, newline-delimited, object

CSV options:

CREATE TABLE [releases] (
   [html_url] TEXT,
   [node_id] TEXT,
   [tag_name] TEXT,
   [target_commitish] TEXT,
   [name] TEXT,
   [draft] INTEGER,
   [author] INTEGER REFERENCES [users]([id]),
   [prerelease] INTEGER,
   [created_at] TEXT,
   [published_at] TEXT,
   [body] TEXT,
   [repo] INTEGER REFERENCES [repos]([id])
CREATE INDEX [idx_releases_repo]
                ON [releases] ([repo]);
CREATE INDEX [idx_releases_author]
                ON [releases] ([author]);
Powered by Datasette · Query took 36.525ms · About: github-to-sqlite