datasette-write 作者 simonw

Star

README 源代码

datasette-write

PyPI Changelog Tests License

Datasette 插件,提供向数据库写入的 UI

安装

在与 Datasette 相同的环境中安装此插件。

pip install datasette-write

用法

安装插件后,访问您的 Datasette 实例上的 /db/-/write 以提交将针对指定数据库的写入连接执行的 SQL 查询。

默认情况下,只有 root 用户可以访问该页面 - 因此您需要使用 --root 选项运行 Datasette,然后点击终端中显示的链接进行登录并访问该页面。

datasette-write 权限控制访问。您可以使用权限插件,例如 datasette-permissions-sql 来授予对写入界面的额外访问权限。

在查询字符串中传递 ?sql=... 以预填充 SQL 编辑器。

参数化查询

SQL 查询可以包含如下参数

insert into news (title, body)
    values (:title, :body_textarea)

这些将被转换为 /db/-/write 页面上的表单字段。

如果参数名以 _textarea 结尾,它将被渲染为多行文本区域而不是文本输入框。

如果参数名以 _hidden 结尾,它将被渲染为隐藏输入框。

使用 SQL 更新行

在 Datasette 1.0a13 及更高版本中,将为具有 datasette-write 权限的用户在行页面添加一个行操作菜单项,链接到用于更新该行的 SQL 查询。

开发

要在本地设置此插件,首先克隆代码。然后创建一个新的虚拟环境

cd datasette-write
python3 -mvenv venv
source venv/bin/activate

或者如果您正在使用 pipenv

pipenv shell

现在安装依赖项和测试

pip install -e '.[test]'

运行测试

pytest