「大家来找茬」，你知道问题所在吗？

import pandas as pd
from myproject.conf import settings

class MyDataObject:

    def __init__(self, sql_result):
        self.data = pd.DataFrame(sql_result)

    def algorithm_handler(self):
        if not self.data.empty:
            try:
                class_val = settings.CLASSVALUES #存放指定类别的列表
                keywords = settings.KEYWORDS #文本描述中的关键词列表
                df = (
                    self.data
                    .query(
                        """
                        MY_CLASS.isin(@class_val) & \
                        DESC_CONTENT.str.contains(r'|'.join(@keywords))
                        """
                    )
                    .groupby("grp")
                    .agg({"RECORD_ID": len})
                    .sort_values(ascending = False)
                    .reset_index()
                    .rename(columns = {"RECORD_ID": "FREQ"})
                    .assign(TYPE = "XX")
                    .loc[:, [...]]
                )
                return df
            except ValueError:
                log.exception(...)

import pandas as pd
from myproject.conf import settings

class MyDataObject:

    def __init__(self, sql_result):
        self.data = pd.DataFrame(sql_result)

    def algorithm_handler(self):
        if not self.data.empty:
            try:
                class_val = settings.CLASSVALUES, #存放指定类别的列表
                keywords = settings.KEYWORDS #文本描述中的关键词列表
                df = (
                    self.data
                    .query(
                        """
                        MY_CLASS.isin(@class_val) & \
                        DESC_CONTENT.str.contains(r'|'.join(@keywords))
                        """
                    )
                    .groupby("grp")
                    .agg({"RECORD_ID": len})
                    .sort_values(ascending = False)
                    .reset_index()
                    .rename(columns = {"RECORD_ID": "FREQ"})
                    .assign(TYPE = "XX")
                    .loc[:, [...]]
                )
                return df
            except ValueError:
                log.exception(...)

Ugly, but effective.

这个逗号它导致了什么问题

In [1]: a = [1,2],

In [2]: a
Out[2]: ([1, 2],)

In [3]: b = [1,2]

In [4]: b
Out[4]: [1, 2]

In [5]: a = 1, ; a
Out[5]: (1,)

In [6]: a = "1","2", ; a
Out[6]: ('1', '2')

In [7]: a = {"age":10}, ; a
Out[7]: ({'age': 10},)

In [8]: a = "10", [1,2,], ; a
Out[8]: ('10', [1, 2])

逗号在赋值表达式中的作用

In [18]: def tuple_val():
    ...:     return 1,2,3
    ...:

In [19]: type(tuple_val())
Out[19]: tuple

In [23]: a, b, c = tuple_val()

In [24]: print("{a}-{b}-{c}".format(a=a, b=b, c=c))
1-2-3

In [26]: a, = [1,]

In [27]: a
Out[27]: 1

In [29]: a, = [1,2]
---------------------------------------------------------------------------
ValueError                                Traceback (most recent call last)
-29-d160930f24aa> in 
----> 1 a, = [1,2]

ValueError: too many values to unpack (expected 1)

A tuple consists of a number of values separated by commas

ValueError: too many values to unpack (expected 1)
In [30]: a = [
    ...:     1,
    ...:     2,
    ...:     3,
    ...: ]

In [31]: a
Out[31]: [1, 2, 3]

In [32]: def tuple_test(a, b, c,):
    ...:     print(a, b, c,)
    ...:

In [33]: tuple_test(1,2,3,)
1 2 3

结语

from typing import Union

f: str = "hello, world"

def foo(
    x: Union[int, float],
    y: Union[int, float],
) -> Union[int, float]:
    return x + y

只要事先进行类型注解，那么借助 IDE（我用的是 Pycharm），就能直接暴露出问题或给出相对应的提示：

现在火热的 TypeScript 也是在 JavaScript 的基础上加上了静态类型提示，使得在编译时能够及时发现问题。

可能对于写惯 Python 的人来说多写一些类型注解是那么的繁琐，也有人会觉得用 Python 的最初目的就是能够通过简单的代码来实现其他编译型语言的一些功能，如果还要为这样的动态语言加上一些加锁，那为什么不直接用 Java 或者是 Go 这样的编译型语言呢？

对我个人来说，使用 Python 的初心确实是因为它简单易学好上手，但事上没有十全十美的东西，简单，就意味着要付出代价。至于这个代价是什么，每个人的解读是因人而异。

但为了让自己少掉点头发、少加些班、程序少些 Bug，还是由衷希望协作的同事甚至是每一个 Pythonic 都能采用 Type Hint 的写法，让代码更加健壮的同时也能少踩一些坑。