Khi làm việc với các dịch vụ siêu nhỏ trong Python, một mẫu phổ biến mà tôi thấy là—việc sử dụng các từ điển được điền động dưới dạng tải trọng của API REST hoặc hàng đợi tin nhắn. Để hiểu ý của tôi về điều này, hãy xem xét ví dụ sau
# src.py
from __future__ import annotations
import json
from typing import Any
import redis # Do a pip install.
def get_payload[] -> dict[str, Any]:
"""Get the 'zoo' payload containing animal names and attributes."""
payload = {"name": "awesome_zoo", "animals": []}
names = ["wolf", "snake", "ostrich"]
attributes = [
{"family": "Canidae", "genus": "Canis", "is_mammal": True},
{"family": "Viperidae", "genus": "Boas", "is_mammal": False},
]
for name, attr in zip[names, attributes]:
payload["animals"].append[ # type: ignore
{"name": name, "attribute": attr},
]
return payload
def save_to_cache[payload: dict[str, Any]] -> None:
# You'll need to spin up a Redis db before instantiating
# a connection here.
r = redis.Redis[]
print["Saving to cache..."]
r.set[f"zoo:{payload['name']}", json.dumps[payload]]
if __name__ == "__main__":
payload = get_payload[]
save_to_cache[payload]
Ở đây, hàm
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
Nếu bạn chạy đoạn mã trên sau khi khởi tạo máy chủ Redis, nó sẽ chạy mà không gây ra bất kỳ lỗi nào. Bạn có thể kiểm tra nội dung được lưu trong Redis bằng lệnh sau [giả sử bạn đã cài đặt
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
echo "get zoo:awesome_zoo" | redis-cli | jq
Điều này sẽ trả lại tải trọng sau cho bảng điều khiển của bạn
________số 8_______
Mặc dù quy trình công việc này hoạt động trong thời gian chạy, nhưng có một vấn đề lớn ở đây. Rất khó để hình dung hình dạng của
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
Trong trường hợp này, bạn sẽ phải kiểm tra nội dung của bộ đệm Redis để hiểu đầy đủ về hình dạng của dữ liệu. Viết mã theo cách trên là dễ dàng nhưng nó khiến người tiếp theo làm việc trên cơ sở mã thực sự khó hiểu được trọng tải trông như thế nào mà không cần chạm vào bộ lưu trữ dữ liệu. Có một cách tốt hơn để truyền đạt một cách khai báo hình dạng của tải trọng mà không liên quan đến việc viết các chuỗi tài liệu lớn không thể xác định được. Đây là cách bạn có thể tận dụng
echo "get zoo:awesome_zoo" | redis-cli | jq
echo "get zoo:awesome_zoo" | redis-cli | jq
# src.py
from __future__ import annotations
import json
# In < Python 3.8, import 'TypedDict' from 'typing_extensions'.
# In < Python 3.9, import 'Annotated' from 'typing_extensions'.
from typing import Annotated, Any, TypedDict
import redis # Do a pip install.
class Attribute[TypedDict]:
family: str
genus: str
is_mammal: bool
class Animal[TypedDict]:
name: str
attribute: Attribute
class Zoo[TypedDict]:
name: str
animals: list[Animal]
def get_payload[] -> Zoo:
"""Get the 'zoo' payload containing animal names and attributes."""
payload: Zoo = {"name": "awesome_zoo", "animals": []}
names = ["wolf", "snake", "ostrich"]
attributes: tuple[Attribute, ...] = [
{"family": "Canidae", "genus": "Canis", "is_mammal": True},
{"family": "Viperidae", "genus": "Boas", "is_mammal": False},
]
for name, attr in zip[names, attributes]:
payload["animals"].append[{"name": name, "attribute": attr}]
return payload
def save_to_cache[payload: Annotated[Zoo, dict]] -> None:
# You'll need to spin up a Redis db before instantiating
# a connection here.
r = redis.Redis[]
print["Saving to cache..."]
r.set[f"zoo:{payload['name']}", json.dumps[payload]]
if __name__ == "__main__":
payload: Zoo = get_payload[]
save_to_cache[payload]
Lưu ý, cách tôi đã sử dụng
echo "get zoo:awesome_zoo" | redis-cli | jq
echo "get zoo:awesome_zoo" | redis-cli | jq
echo "get zoo:awesome_zoo" | redis-cli | jq
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
docker run -d -p 6379:6379 redis:alpine
{
"name": "awesome_zoo",
"animals": [
{
"name": "wolf",
"attribute": {
"family": "Canidae",
"genus": "Canis",
"is_mammal": true
}
},
{
"name": "snake",
"attribute": {
"family": "Viperidae",
"genus": "Boas",
"is_mammal": false
}
}
]
}
{
"name": "awesome_zoo",
"animals": [
{
"name": "wolf",
"attribute": {
"family": "Canidae",
"genus": "Canis",
"is_mammal": true
}
},
{
"name": "snake",
"attribute": {
"family": "Viperidae",
"genus": "Boas",
"is_mammal": false
}
}
]
}
{
"name": "awesome_zoo",
"animals": [
{
"name": "wolf",
"attribute": {
"family": "Canidae",
"genus": "Canis",
"is_mammal": true
}
},
{
"name": "snake",
"attribute": {
"family": "Viperidae",
"genus": "Boas",
"is_mammal": false
}
}
]
}
{
"name": "awesome_zoo",
"animals": [
{
"name": "wolf",
"attribute": {
"family": "Canidae",
"genus": "Canis",
"is_mammal": true
}
},
{
"name": "snake",
"attribute": {
"family": "Viperidae",
"genus": "Boas",
"is_mammal": false
}
}
]
}
Nhìn vào typed-dict
echo "get zoo:awesome_zoo" | redis-cli | jq
{
"name": "awesome_zoo",
"animals": [
{
"name": "wolf",
"attribute": {
"family": "Canidae",
"genus": "Canis",
"is_mammal": true
}
},
{
"name": "snake",
"attribute": {
"family": "Viperidae",
"genus": "Boas",
"is_mammal": false
}
}
]
}
docker run -d -p 6379:6379 redis:alpine
echo "get zoo:awesome_zoo" | redis-cli | jq
echo "get zoo:awesome_zoo" | redis-cli | jq
Trong thời gian chạy, đoạn mã này sẽ thể hiện hành vi tương tự như đoạn mã trước. Mypy cũng phê duyệt điều này
Xử lý các cặp khóa-giá trị bị thiếu
Theo mặc định, trình kiểm tra loại sẽ xác thực cấu trúc hình dạng của chính tả được chú thích bằng một lớp
echo "get zoo:awesome_zoo" | redis-cli | jq
from __future__ import annotations
from typing import TypedDict
class Attribute[TypedDict]:
family: str
genus: str
is_mammal: bool
animal_attribute: Attribute = {
"family": "Hominidae",
"genus": "Homo",
} # Mypy will complain about the missing 'is_mammal' key.
Mypy sẽ phàn nàn về việc thiếu chìa khóa
src.py:12: error: Missing key "is_mammal" for TypedDict "Attribute"
animal_attribute: Attribute = {
^
Found 1 error in 1 file [checked 1 source file]
Bạn có thể thư giãn hành vi này như thế này
...
class Attribute[TypedDict, total=False]:
family: str
genus: str
is_mammal: bool
...
Bây giờ Mypy sẽ không còn phàn nàn về trường bị thiếu trong chính tả được chú thích nữa. Tuy nhiên, điều này vẫn sẽ không cho phép các khóa tùy ý không được xác định trong
echo "get zoo:awesome_zoo" | redis-cli | jq
TypedDict Python là gì?
TypedDict là một loại kiểu mới được công cụ đánh máy Python nhận dạng như mypy . Nó mô tả một từ điển/bản đồ có cấu trúc với một tập hợp các khóa chuỗi được đặt tên dự kiến được ánh xạ tới các giá trị của các loại dự kiến cụ thể. Các cấu trúc như vậy phổ biến khi trao đổi dữ liệu JSON, điều này thường xảy ra đối với các ứng dụng web Python.
Khi nào tôi nên sử dụng TypedDict?
TypedDict để hỗ trợ trường hợp sử dụng trong đó một đối tượng từ điển có một bộ khóa chuỗi cụ thể, mỗi khóa có một giá trị của một loại cụ thể .
Làm cách nào để sử dụng các loại trong Python?
Cú pháp hàm type[] trong Python
. Khi một đối số duy nhất được chuyển đến hàm type[], nó sẽ trả về kiểu của đối tượng. Giá trị của nó giống như đối tượng. __class__ biến thể hiện. The type[] function is used to get the type of an object. When a single argument is passed to the type[] function, it returns the type of the object. Its value is the same as the object. __class__ instance variable.
Chú thích kiểu trong Python là gì?
Chú thích loại là gì. ? . used to indicate the data types of variables and inputs/outputs of functions and methods.