如何向用户界提供类型的暗示？

Question

我想定义一个userDict，该读取JSON的值并存储给定密钥的位置。 JSON文件看起来像这样：

{
    "pages": [
        {
            "areas": [
                {
                    "name": "My_Name",
                    "x": 179.95495495495493,
                    "y": 117.92792792792793,
                    "height": 15.315315315315303,
                    "width": 125.58558558558553
                },
                ...
              ]
        }
    ]
}

我想指出键入linter（例如mypy），该字典是字符串，值为position。

我当前的代码如下：

import json
from collections import UserDict
from dataclasses import dataclass, field
from pathlib import Path
from typing import Dict, List, Optional, Union

from typing_extensions import Literal


JsonPosition = Dict[str, Union[str, float]]
JsonPage = Optional[Dict[Literal["areas"], List[JsonPosition]]]


@dataclass
class Position:
    """Information for a position"""

    name: str
    x: float
    y: float
    width: float
    height: float

    @classmethod
    def from_json(cls, dict_values: JsonPosition):
        return cls(**dict_values)  # type: ignore  # dynamic typing


class Page(UserDict):
    """Information about positions on a page"""

    @classmethod
    def from_json(cls, page: JsonPage):
        """Get positions from JSON Dictionary"""
        if page is None:
            return cls()

        return cls({cast(str, p["name"]): Position.from_json(p) for p in page["areas"]})



JSON = Path("my_positions.json").read_text()
positions = json.loads(JSON)
page_1 = Page.from_json(positions["pages"][0])

我希望Mypy（或塔属或我使用的任何类型的Hinter）自动识别page_1 [“ my_name”]作为position。

我可以改变什么？

Answer 1

实际上，您可以将类型直接提供给userDict带有方括号（[...]）的

class Page(UserDict[str, Position]):
    ...

类型strong> python 3.6 或更早，这将行不通。

对于 python＆gt; = 3.7和＆lt; 3.9 ，您需要以下 to inscript collections.userdict并将其放在特定于键入检查的单独块中（使用常数type_checking）：

from __future__ import annotations
from collections import UserDict
from typing import TYPE_CHECKING

if TYPE_CHECKING:
    TypedUserDict = UserDict[str, Position]
else:
    TypedUserDict = UserDict


class Page(TypedUserDict):
    ...

for python 3.9+，无需其他进口或技巧。