Files
MoviePilot/app/schemas/comment.py
cosini e36884766c feat(douban): 新增豆瓣短评与影评接口
* feat(douban): 新增豆瓣短评与影评接口

* fix(douban): satisfy comment endpoint CI gates

---------

Co-authored-by: jxxghp <jxxghp@gmail.com>
2026-10-17 12:31:41 +08:00

59 lines
2.8 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""豆瓣短评与影评的稳定结果模型。"""
from typing import Optional
from pydantic import BaseModel, Field
class MediaCommentAuthor(BaseModel): # type: ignore[misc]
"""评论作者的身份投影。"""
id: Optional[str] = Field(default=None, description="作者 ID")
name: Optional[str] = Field(default=None, description="作者昵称")
avatar: Optional[str] = Field(default=None, description="作者头像地址")
url: Optional[str] = Field(default=None, description="作者主页地址")
class MediaComment(BaseModel): # type: ignore[misc]
"""豆瓣短评条目,评分按豆瓣五分制归一。"""
id: Optional[str] = Field(default=None, description="短评 ID")
comment: Optional[str] = Field(default=None, description="短评正文")
rating: Optional[float] = Field(default=None, description="五星制评分")
vote_count: Optional[int] = Field(default=None, description="有用数")
create_time: Optional[str] = Field(default=None, description="发表时间")
author: Optional[MediaCommentAuthor] = Field(default=None, description="作者信息")
url: Optional[str] = Field(default=None, description="短评地址")
class MediaReview(BaseModel): # type: ignore[misc]
"""豆瓣影评条目,正文以摘要形式返回。"""
id: Optional[str] = Field(default=None, description="影评 ID")
title: Optional[str] = Field(default=None, description="影评标题")
abstract: Optional[str] = Field(default=None, description="影评摘要")
rating: Optional[float] = Field(default=None, description="五星制评分")
useful_count: Optional[int] = Field(default=None, description="有用数")
comments_count: Optional[int] = Field(default=None, description="回应数")
create_time: Optional[str] = Field(default=None, description="发表时间")
author: Optional[MediaCommentAuthor] = Field(default=None, description="作者信息")
url: Optional[str] = Field(default=None, description="影评地址")
class MediaCommentPage(BaseModel): # type: ignore[misc]
"""短评分页结果,total 为豆瓣侧的总条目数。"""
start: int = Field(default=0, description="起始偏移")
count: int = Field(default=0, description="本页条目数")
total: int = Field(default=0, description="总条目数")
items: list[MediaComment] = Field(default_factory=list, description="短评列表")
class MediaReviewPage(BaseModel): # type: ignore[misc]
"""影评分页结果,total 为豆瓣侧的总条目数。"""
start: int = Field(default=0, description="起始偏移")
count: int = Field(default=0, description="本页条目数")
total: int = Field(default=0, description="总条目数")
items: list[MediaReview] = Field(default_factory=list, description="影评列表")