# 字符串拼接中，支持使用 f-strings 的 inline 拼接方法
# 终于能像 JS 那样方便地进行字符串拼接了
name = "ackerr"
precision = 2
height = 183.2
assert f"{name} is {height:0.{precision}f}cm tall." == "ackerr is 183.20cm tall."

# 常数定义中，可以使用下划线增加可阅读性
number = 3_735_928_559
magic = 0xDEAD_BEEF
assert number == magic

# 变量定义中，支持类型声明了
# 值得注意的是 Python 依旧不是强类型，只是写在了 __annotations__ 这个变量里
import typing
numbers: typing.List[int] = [1,1,4,5,1,4]
complex_data: typing.Dict[int, typing.Set[int]] = {}
assert "complex_data" in __annotations__

# 加了一个 enum.auto 的函数，开发者不用费心去自增了
import enum
class Colors(enum.Enum):
    R = enum.auto()
    G = enum.auto()
    B = enum.auto()

assert Colors.B.value == 3

# 类型系统支持惰性求值了，可以不需要用字符串来指代自己了
from __future__ import annotations
class QuerySet:
    def filter(self, **params) -> QuerySet:
        """some database filter"""


# 新增了 dataclass 标准包
# 相比于 dict 传参大大优化了可读性
import dataclasses as dc
@dc.dataclass
class Person:
    name: str
    age: int
    gender: str = 'Unknown'

assert Person('me', '24').gender == 'Unknown'

# 新增了赋值判断的语法（也被形象地叫做海象操作符）
import re
if match := re.search(r"(\d+)%", "Total coverage: 80%"):
    print("Coverage is {match.group(1)}")

# 函数支持用 `/` 限制非命名参数
def calculate_data_length(data, /):
    pass

# 官方指出，这种情况 `calculate_data_length(data=data)` 的可读性显然更低，其实可以在定义函数时禁掉
# 而且该语法可以避免 `**kwargs` 传参冲突的情况
def get_values(data, /, **kwargs):
    print(data, kwargs)

get_values({}, data='some_data')

# f-strings 支持了自解释的语法
name = "ackerr"
assert f"Debug: {name=}" == "Debug: name='ackerr'"

# 新增了 `functools.cached_property` 方法，支持属性的缓存
import functools
class DB:
    @functools.cached_property
    def connection(self):
        print(1)

db = DB()
assert db.connection == None
assert db.connection == None

# dict 支持并集操作符 `|` 了
x = {"a": 1, "b": 2}
y = {"b": 3, "c": 4}
assert x | y == {"a": 1, "b": 3, "c": 4}
assert y | x == {"a": 1, "b": 2, "c": 4}

# 支持 `list`/`dict`/`set` 这样的原生类型作为类型标注
def occurance(names: list[str]) -> dict[str, int]:
    return {name: names.count(name) for name in names}

# 新增了类似 switch+case 的 match+case 语法
def check(status_code: int, message: str):
    match status_code:
        case 200 if message:
            return message
        case 200:
            return "ok"
        case 400:
            return "bad request"
        case 500 | 502 | 503:
            return "something wrong"
        case _:
            return "not implemented"

# `typing.Union` 可以写成更优雅的 `|`
def add_all(*numbers: int | float) -> int | float:
    return sum(numbers)

assert isinstance(42, int | float)

# `dataclass` 支持 keyword-only 模式
import dataclasses as dc
@dc.dataclass(kw_only=True)
class Person:
    name: str
    age: int
    gender: str = 'Unknown'