SQL-tString：安全构建SQL查询的开源项目

1. 项目介绍

SQL-tString 是一个开源项目，旨在为 Python 开发者提供一个安全、便捷的方式来构建 SQL 查询，避免 SQL 注入的风险。它允许开发者使用类似于 Python f-string 的语法来构造 SQL 语句，并且能够自动将变量转换为 SQL 占位符。

2. 项目快速启动

在您的 Python 项目中，首先需要安装 SQL-tString。可以通过以下代码安装：

pip install sql-tstring

安装完成后，可以开始构建您的第一个查询。以下是一个简单的例子：

from sql_tstring import sql

a = 1
query, values = sql("SELECT a, b, c FROM tbl WHERE a = {a}")

在这个例子中，{a} 会被替换为 a 变量的值，并且自动转换为 SQL 的占位符，以防止 SQL 注入。

3. 应用案例和最佳实践

3.1 安全查询构建

使用 SQL-tString，您可以安全地构建包含参数的查询，而不用担心 SQL 注入问题。例如：

from sql_tstring import sql

user_id = 2
query, values = sql("SELECT * FROM users WHERE id = {user_id}")

3.2 动态表名和列名

SQL-tString 还允许您动态地使用表名和列名，只要在 sql_context 中进行了定义：

from sql_tstring import sql, sql_context

col = "username"
table = "users"
with sql_context(columns={col}, tables={table}):
    query, values = sql("SELECT {col} FROM {table}")

3.3 重写查询值

SQL-tString 允许您使用特殊的 Absent 值来重写查询中的某些部分，这对于处理可选更新或条件非常有用：

from sql_tstring import sql, Absent

a = Absent
b = 1
query, values = sql("UPDATE tbl SET a = {a}, b = 1 WHERE b = {b}")

在上面的例子中，由于 a 是 Absent，所以它会被从查询中移除。

4. 典型生态项目

目前，SQL-tString 社区还比较小，但已经有了一些典型的生态项目，例如：

• 为不同数据库方言提供适配器，如 asyncpg。
• 开发者工具，用于集成 SQL-tString 到各种 IDE 和编辑器中。

SQL-tString 项目的开源性质鼓励开发者贡献代码，共同推动项目的发展和完善。