Wemake Python风格指南：多行字符串与函数调用的正确格式

在Python开发中，多行字符串与函数调用的结合使用是一个常见场景，特别是在处理SQL查询、模板生成等任务时。本文将以Wemake Python风格指南为背景，探讨如何正确处理这类代码格式问题。

问题现象

当开发者尝试在函数调用中使用多行f-string字符串时，可能会遇到WPS319规则（括号位置错误）的警告。这种情况通常出现在类似以下代码中：

def generate_query(config):
    columns = f"{{{{ athena.column_names('{config.database}', '{config.table}') }}}}"
    return dedent(f"""
        insert into {config.result_database}.{config.result_table} ({columns})
        select {columns} from {config.inc_database}.{config.inc_table}
    """)

问题分析

Wemake Python风格指南对代码格式有严格要求，特别是在函数调用与多行字符串结合使用时。上述代码的问题在于：

1. 函数调用的左括号与多行字符串的起始位置不符合规范
2. 字符串的缩进与函数调用的格式不协调
3. 右括号的位置可能导致可读性问题

正确解决方案

根据Wemake Python风格指南的最佳实践，正确的格式应该是：

def generate_query(config):
    columns = f"{{{{ athena.column_names('{config.database}', '{config.table}') }}}}"
    return dedent(
        f"""
        insert into {config.result_database}.{config.result_table} ({columns})
        select {columns} from {config.inc_database}.{config.inc_table}
        """
    )

这种格式具有以下优点：

1. 函数调用的括号单独成行，提高可读性
2. 多行字符串与函数调用形成清晰的视觉层次
3. 字符串内容保持一致的缩进
4. 右括号与函数调用对齐，明确表示代码块的结束

风格演变

值得注意的是，在Wemake Python风格指南的1.0.0版本中，WPS319规则已被移除。这反映了Python社区对代码格式灵活性的逐渐认可，但遵循上述格式仍然是保持代码一致性和可读性的良好实践。

总结

在Python开发中，特别是使用严格的风格指南时，正确处理多行字符串与函数调用的格式非常重要。通过将函数调用的括号单独成行，并保持字符串内容的适当缩进，可以显著提高代码的可读性和维护性。虽然某些严格的规则可能会随着时间放宽，但遵循这些格式规范仍然是编写高质量Python代码的重要方面。