{"id": "plugin_hooks:plugin-hook-view-actions", "page": "plugin_hooks", "ref": "plugin-hook-view-actions", "title": "view_actions(datasette, actor, database, view, request)", "content": "datasette  -  Datasette class \n                         \n                             You can use this to access plugin configuration options via  datasette.plugin_config(your_plugin_name) , or to execute SQL queries. \n                         \n                     \n                     \n                         actor  - dictionary or None \n                         \n                             The currently authenticated  actor . \n                         \n                     \n                     \n                         database  - string \n                         \n                             The name of the database. \n                         \n                     \n                     \n                         view  - string \n                         \n                             The name of the SQL view. \n                         \n                     \n                     \n                         request  -  Request object  or None \n                         \n                             The current HTTP request. This can be  None  if the request object is not available. \n                         \n                     \n                 \n                 Like  table_actions(datasette, actor, database, table, request)  but for SQL views.", "breadcrumbs": "[\"Plugin hooks\", \"Action hooks\"]", "references": "[]"}
{"id": "plugin_hooks:plugin-hook-table-actions", "page": "plugin_hooks", "ref": "plugin-hook-table-actions", "title": "table_actions(datasette, actor, database, table, request)", "content": "datasette  -  Datasette class \n                         \n                             You can use this to access plugin configuration options via  datasette.plugin_config(your_plugin_name) , or to execute SQL queries. \n                         \n                     \n                     \n                         actor  - dictionary or None \n                         \n                             The currently authenticated  actor . \n                         \n                     \n                     \n                         database  - string \n                         \n                             The name of the database. \n                         \n                     \n                     \n                         table  - string \n                         \n                             The name of the table. \n                         \n                     \n                     \n                         request  -  Request object  or None \n                         \n                             The current HTTP request. This can be  None  if the request object is not available. \n                         \n                     \n                 \n                 This example adds a new table action if the signed in user is  \"root\" : \n                 from datasette import hookimpl\n\n\n@hookimpl\ndef table_actions(datasette, actor, database, table):\n    if actor and actor.get(\"id\") == \"root\":\n        return [\n            {\n                \"href\": datasette.urls.path(\n                    \"/-/edit-schema/{}/{}\".format(\n                        database, table\n                    )\n                ),\n                \"label\": \"Edit schema for this table\",\n                \"description\": \"Add, remove, rename or alter columns for this table.\",\n            }\n        ] \n                 Example:  datasette-graphql", "breadcrumbs": "[\"Plugin hooks\", \"Action hooks\"]", "references": "[{\"href\": \"https://datasette.io/plugins/datasette-graphql\", \"label\": \"datasette-graphql\"}]"}
{"id": "plugin_hooks:plugin-hook-row-actions", "page": "plugin_hooks", "ref": "plugin-hook-row-actions", "title": "row_actions(datasette, actor, request, database, table, row)", "content": "datasette  -  Datasette class \n                         \n                             You can use this to access plugin configuration options via  datasette.plugin_config(your_plugin_name) , or to execute SQL queries. \n                         \n                     \n                     \n                         actor  - dictionary or None \n                         \n                             The currently authenticated  actor . \n                         \n                     \n                     \n                         request  -  Request object  or None \n                         \n                             The current HTTP request. \n                         \n                     \n                     \n                         database  - string \n                         \n                             The name of the database. \n                         \n                     \n                     \n                         table  - string \n                         \n                             The name of the table. \n                         \n                     \n                     \n                         row  -  sqlite.Row \n                         \n                             The SQLite row object being displayed on the page. \n                         \n                     \n                 \n                 Return links for the \"Row actions\" menu shown at the top of the row page. \n                 This example displays the row in JSON plus some additional debug information if the user is signed in: \n                 from datasette import hookimpl\n\n\n@hookimpl\ndef row_actions(datasette, database, table, actor, row):\n    if actor:\n        return [\n            {\n                \"href\": datasette.urls.instance(),\n                \"label\": f\"Row details for {actor['id']}\",\n                \"description\": json.dumps(\n                    dict(row), default=repr\n                ),\n            },\n        ] \n                 Example:  datasette-enrichments", "breadcrumbs": "[\"Plugin hooks\", \"Action hooks\"]", "references": "[{\"href\": \"https://datasette.io/plugins/datasette-enrichments\", \"label\": \"datasette-enrichments\"}]"}
{"id": "plugin_hooks:plugin-hook-query-actions", "page": "plugin_hooks", "ref": "plugin-hook-query-actions", "title": "query_actions(datasette, actor, database, query_name, request, sql, params)", "content": "datasette  -  Datasette class \n                         \n                             You can use this to access plugin configuration options via  datasette.plugin_config(your_plugin_name) , or to execute SQL queries. \n                         \n                     \n                     \n                         actor  - dictionary or None \n                         \n                             The currently authenticated  actor . \n                         \n                     \n                     \n                         database  - string \n                         \n                             The name of the database. \n                         \n                     \n                     \n                         query_name  - string or None \n                         \n                             The name of the canned query, or  None  if this is an arbitrary SQL query. \n                         \n                     \n                     \n                         request  -  Request object \n                         \n                             The current HTTP request. \n                         \n                     \n                     \n                         sql  - string \n                         \n                             The SQL query being executed \n                         \n                     \n                     \n                         params  - dictionary \n                         \n                             The parameters passed to the SQL query, if any. \n                         \n                     \n                 \n                 Populates a \"Query actions\" menu on the canned query and arbitrary SQL query pages. \n                 This example adds a new query action linking to a page for explaining a query: \n                 from datasette import hookimpl\nimport urllib\n\n\n@hookimpl\ndef query_actions(datasette, database, query_name, sql):\n    # Don't explain an explain\n    if sql.lower().startswith(\"explain\"):\n        return\n    return [\n        {\n            \"href\": datasette.urls.database(database)\n            + \"?\"\n            + urllib.parse.urlencode(\n                {\n                    \"sql\": \"explain \" + sql,\n                }\n            ),\n            \"label\": \"Explain this query\",\n            \"description\": \"Get a summary of how SQLite executes the query\",\n        },\n    ] \n                 Example:  datasette-create-view", "breadcrumbs": "[\"Plugin hooks\", \"Action hooks\"]", "references": "[{\"href\": \"https://datasette.io/plugins/datasette-create-view\", \"label\": \"datasette-create-view\"}]"}
{"id": "plugin_hooks:plugin-hook-homepage-actions", "page": "plugin_hooks", "ref": "plugin-hook-homepage-actions", "title": "homepage_actions(datasette, actor, request)", "content": "datasette  -  Datasette class \n                         \n                             You can use this to access plugin configuration options via  datasette.plugin_config(your_plugin_name) , or to execute SQL queries. \n                         \n                     \n                     \n                         actor  - dictionary or None \n                         \n                             The currently authenticated  actor . \n                         \n                     \n                     \n                         request  -  Request object \n                         \n                             The current HTTP request. \n                         \n                     \n                 \n                 Populates an actions menu on the top-level index homepage of the Datasette instance. \n                 This example adds a link an imagined tool for editing the homepage, only for signed in users: \n                 from datasette import hookimpl\n\n\n@hookimpl\ndef homepage_actions(datasette, actor):\n    if actor:\n        return [\n            {\n                \"href\": datasette.urls.path(\n                    \"/-/customize-homepage\"\n                ),\n                \"label\": \"Customize homepage\",\n            }\n        ]", "breadcrumbs": "[\"Plugin hooks\", \"Action hooks\"]", "references": "[]"}
{"id": "plugin_hooks:plugin-hook-database-actions", "page": "plugin_hooks", "ref": "plugin-hook-database-actions", "title": "database_actions(datasette, actor, database, request)", "content": "datasette  -  Datasette class \n                         \n                             You can use this to access plugin configuration options via  datasette.plugin_config(your_plugin_name) , or to execute SQL queries. \n                         \n                     \n                     \n                         actor  - dictionary or None \n                         \n                             The currently authenticated  actor . \n                         \n                     \n                     \n                         database  - string \n                         \n                             The name of the database. \n                         \n                     \n                     \n                         request  -  Request object \n                         \n                             The current HTTP request. \n                         \n                     \n                 \n                 Populates an actions menu on the database page. \n                 This example adds a new database action for creating a table, if the user has the  edit-schema  permission: \n                 from datasette import hookimpl\n\n\n@hookimpl\ndef database_actions(datasette, actor, database):\n    async def inner():\n        if not await datasette.permission_allowed(\n            actor,\n            \"edit-schema\",\n            resource=database,\n            default=False,\n        ):\n            return []\n        return [\n            {\n                \"href\": datasette.urls.path(\n                    \"/-/edit-schema/{}/-/create\".format(\n                        database\n                    )\n                ),\n                \"label\": \"Create a table\",\n            }\n        ]\n\n    return inner \n                 Example:  datasette-graphql ,  datasette-edit-schema", "breadcrumbs": "[\"Plugin hooks\", \"Action hooks\"]", "references": "[{\"href\": \"https://datasette.io/plugins/datasette-graphql\", \"label\": \"datasette-graphql\"}, {\"href\": \"https://datasette.io/plugins/datasette-edit-schema\", \"label\": \"datasette-edit-schema\"}]"}