From d4cc1374f4faaa1850a42c7508a196a277216bbc Mon Sep 17 00:00:00 2001 From: Simon Willison Date: Tue, 13 Dec 2022 14:28:59 -0800 Subject: [PATCH] Improved --help for create-token, refs #1947 --- datasette/cli.py | 12 +++++++++--- docs/cli-reference.rst | 11 ++++++++--- 2 files changed, 17 insertions(+), 6 deletions(-) diff --git a/datasette/cli.py b/datasette/cli.py index e8595321..f9faf026 100644 --- a/datasette/cli.py +++ b/datasette/cli.py @@ -701,13 +701,19 @@ def create_token( datasette create-token root --secret mysecret - To only allow create-table: + To allow only "view-database-download" for all databases: \b datasette create-token root --secret mysecret \\ - --all create-table + --all view-database-download - Or to only allow insert-row against a specific table: + To allow "create-table" against a specific database: + + \b + datasette create-token root --secret mysecret \\ + --database mydb create-table + + To allow "insert-row" against a specific table: \b datasette create-token root --secret myscret \\ diff --git a/docs/cli-reference.rst b/docs/cli-reference.rst index 80f31924..5cac71ce 100644 --- a/docs/cli-reference.rst +++ b/docs/cli-reference.rst @@ -624,12 +624,17 @@ Create a signed API token, see :ref:`authentication_cli_create_token`. datasette create-token root --secret mysecret - To only allow create-table: + To allow only "view-database-download" for all databases: datasette create-token root --secret mysecret \ - --all create-table + --all view-database-download - Or to only allow insert-row against a specific table: + To allow "create-table" against a specific database: + + datasette create-token root --secret mysecret \ + --database mydb create-table + + To allow "insert-row" against a specific table: datasette create-token root --secret myscret \ --resource mydb mytable insert-row