Python函数生成器

以下是根据需求生成的Python函数实现，用于动态生成SQL查询语句。函数名为generate_sql_query，并已加入参数校验和逻辑注释。

def generate_sql_query(table_name, columns, where_conditions=None):
    """
    动态生成SQL查询语句。
    
    :param table_name: str - 数据库表名 (必须是非空字符串)。
    :param columns: list or tuple - 要查询的列名 (必须是非空的列表或元组，元素必须是字符串)。
    :param where_conditions: dict or None - 生成WHERE子句的条件，每个键值对表示条件 (可选)。
                              键为列名，值为该列需匹配的值。
    :return: str - 生成的SQL查询语句。
    
    :raises ValueError: 如果输入参数不符合要求，则抛出异常。
    """
    # 校验表名
    if not isinstance(table_name, str) or not table_name.strip():
        raise ValueError("Table name must be a non-empty string.")
    
    # 校验列名
    if not isinstance(columns, (list, tuple)) or len(columns) == 0:
        raise ValueError("Columns must be a non-empty list or tuple.")
    if not all(isinstance(col, str) and col.strip() for col in columns):
        raise ValueError("Each column name must be a non-empty string.")
    
    # 校验WHERE条件 (如果有)
    if where_conditions is not None:
        if not isinstance(where_conditions, dict):
            raise ValueError("Where conditions must be a dictionary.")
        for key, value in where_conditions.items():
            if not isinstance(key, str) or not key.strip():
                raise ValueError("Each key in where_conditions must be a non-empty string.")
    
    # 防止SQL注入: 将列名和表名用反引号括起来 (假定使用支持此语法的数据库，如MySQL)
    table_name = f"`{table_name.strip()}`"
    columns = ", ".join(f"`{col.strip()}`" for col in columns)
    
    # 生成基本的SELECT语句
    query = f"SELECT {columns} FROM {table_name}"
    
    # 如果存在WHERE条件，则附加WHERE子句
    if where_conditions:
        where_clauses = []
        for column, value in where_conditions.items():
            if isinstance(value, str):
                # 字符串值加单引号
                value = f"'{value.replace('\'', '\'\'')}'"  # 转义单引号
            elif value is None:
                # 如果值为None，转换为SQL的NULL
                value = "NULL"
            elif not isinstance(value, (int, float)):
                # 不允许其他类型
                raise ValueError(f"Unsupported value type for column `{column}`: {type(value)}")
            else:
                # 数字类型不加引号
                value = str(value)
            where_clauses.append(f"`{column.strip()}` = {value}")
        query += " WHERE " + " AND ".join(where_clauses)
    
    return query

函数示例用法：

# 示例1：基本查询
sql1 = generate_sql_query("users", ["id", "name", "email"])
print(sql1)
# 输出: SELECT `id`, `name`, `email` FROM `users`

# 示例2：带WHERE条件的查询
sql2 = generate_sql_query(
    "orders",
    ["order_id", "customer_id", "amount"],
    {"customer_id": 123, "status": "confirmed", "amount": 500.75}
)
print(sql2)
# 输出: SELECT `order_id`, `customer_id`, `amount` FROM `orders` WHERE `customer_id` = 123 AND `status` = 'confirmed' AND `amount` = 500.75

# 示例3：包含NULL值的WHERE条件
sql3 = generate_sql_query(
    "products",
    ["product_id", "product_name"],
    {"category_id": None, "is_available": 1}
)
print(sql3)
# 输出: SELECT `product_id`, `product_name` FROM `products` WHERE `category_id` = NULL AND `is_available` = 1

说明

1. SQL注入保护：
   • 表名和列名用反引号括起来，避免非法字符。
   • 字符串中的单引号被转义为SQL安全的形式。
2. 边界情况处理：
   • 表名和列名不能为空。
   • WHERE子句值支持 int、float、str 和 None，其他类型会抛出异常。
3. 代码可读性：
   • 添加了详细注释，方便后续开发者维护。

如果有其他特殊的需求或扩展要求，可以进一步调整代码逻辑。

以下是根据需求实现的Python函数代码。该函数对输入字符串进行反转。

def reverse_string(input_string):
    """
    Function to reverse a given string.
    
    Args:
        input_string (str): The string to be reversed.
        
    Returns:
        str: The reversed string.
        
    Raises:
        TypeError: If the input is not a string.
    """
    # Parameter validation to ensure the input is a string
    if not isinstance(input_string, str):
        raise TypeError("Input must be a string")
    
    # Use Python's slicing feature to reverse the string
    reversed_string = input_string[::-1]
    
    return reversed_string

# Example usage:
# result = reverse_string("hello")
# print(result)  # Output: "olleh"

功能说明

1. 参数验证：函数会验证输入是否为字符串。如果输入不是字符串类型，会抛出 TypeError，确保函数仅接收有效参数。
2. 实现逻辑：利用字符串切片([::-1])的特性反转字符串，从尾到头获取字符。
3. 健壮性：处理空字符串输入。如果输入为空字符串 ""，函数会直接返回空字符串，因为反转结果仍然是空字符串。

使用示例

# 示例1: 普通字符串反转
print(reverse_string("hello"))  # 输出: "olleh"

# 示例2: 空字符串处理
print(reverse_string(""))  # 输出: ""

# 示例3: 单字符字符串
print(reverse_string("a"))  # 输出: "a"

# 示例4: 包含空格或特殊字符的字符串
print(reverse_string("!@ # ~$"))  # 输出: "$~ # @!"