cls.types

  1"""
  2cls/types.py
  3"""
  4
  5from collections.abc import Mapping
  6from datetime import datetime
  7from typing import TYPE_CHECKING, Callable, Literal, TypedDict, Union
  8
  9if TYPE_CHECKING:
 10    from cls.timekit import ExtendedDatetime
 11    from cls.score import GameResult
 12
 13
 14class GameInfoDict(TypedDict):
 15    """ゲーム集計情報格納辞書"""
 16    game_count: int
 17    """ゲーム数"""
 18    first_game: "ExtendedDatetime"
 19    """記録されている最初のゲーム時間"""
 20    last_game: "ExtendedDatetime"
 21    """記録されている最後のゲーム時間"""
 22    first_comment: str | None
 23    """記録されている最初のゲームコメント"""
 24    last_comment: str | None
 25    """記録されている最後のゲームコメント"""
 26
 27
 28class TeamDataDict(TypedDict):
 29    """チーム情報格納辞書"""
 30    id: int
 31    team: str
 32    member: list[str]
 33
 34
 35class ScoreDataDict(TypedDict, total=False):
 36    """スコアデータ格納用辞書"""
 37    ts: str
 38    p1_name: str
 39    p1_str: str
 40    p1_rpoint: int
 41    p1_point: float
 42    p1_rank: int
 43    p2_name: str
 44    p2_str: str
 45    p2_rpoint: int
 46    p2_point: float
 47    p2_rank: int
 48    p3_name: str
 49    p3_str: str
 50    p3_rpoint: int
 51    p3_point: float
 52    p3_rank: int
 53    p4_name: str
 54    p4_str: str
 55    p4_rpoint: int
 56    p4_point: float
 57    p4_rank: int
 58    comment: str | None
 59    deposit: int
 60    rpoint_sum: int
 61    rule_version: str
 62
 63
 64class RemarkDict(TypedDict):
 65    """メモ格納用辞書"""
 66    thread_ts: str
 67    """ゲーム終了時間"""
 68    event_ts: str
 69    """メモ記録時間"""
 70    name: str
 71    matter: str
 72
 73
 74class ComparisonDict(TypedDict, total=False):
 75    """メモ突合用辞書"""
 76    mismatch: str
 77    """差分"""
 78    missing: str
 79    """追加"""
 80    delete: str
 81    """削除"""
 82    remark_mod: str
 83    """メモの修正(追加/削除)"""
 84    remark_del: str
 85    """削除"""
 86    invalid_score: str
 87    """素点合計不一致"""
 88    pending: list[str]
 89    """保留"""
 90
 91
 92class SlackSearchData(TypedDict, total=False):
 93    """slack検索結果格納辞書"""
 94    text: str
 95    """検索にヒットした本文の内容"""
 96    channel_id: str
 97    """見つけたチャンネルID"""
 98    user_id: str
 99    """投稿者のユーザID"""
100    event_ts: str | None
101    """ポストされた時間"""
102    thread_ts: str | None
103    """スレッドになっている場合、スレッド元の時間"""
104    edited_ts: str | None
105    """最後に編集された時間"""
106    reaction_ok: list
107    """botが付けたOKリアクション"""
108    reaction_ng: list
109    """botが付けたNGリアクション"""
110    in_thread: bool
111    """スレッドになっていればTrue(スレッド元は除く)"""
112    score: "GameResult"
113    """スコア報告なら結果"""
114    remarks: list
115    """メモならその内容"""
116
117
118class DateRangeSpec(TypedDict):
119    """日付範囲変換キーワード用辞書"""
120    keyword: list[str]
121    range: Callable[[datetime], list[datetime]]
122
123
124class RankTableDict(TypedDict):
125    """昇段ポイント計算テーブル用辞書"""
126    grade: str
127    point: list
128    acquisition: list
129    demote: bool
130
131
132class GradeTableDict(TypedDict, total=False):
133    """段位テーブル用辞書"""
134    name: str
135    addition_expression: str
136    table: list[RankTableDict]
137
138
139# CommandParser用
140CommandResult = Mapping[str, Union[str, int, bool, tuple[str, ...]]]
141CommandAction = Callable[[Union[str, tuple[str, ...]]], CommandResult]
142
143
144class CommandSpec(TypedDict, total=False):
145    """コマンドマッピング"""
146    match: list[str]
147    action: CommandAction
148    type: Literal["int", "str", "sql", "filename"]