#Context

from dataclasses import dataclass
from pathlib import Path
import logging

@dataclass
class PluginContext:
    """插件上下文"""

    name: str                    # 插件名称
    home: Path                   # 插件专属目录 plugins/{name}/
    logger: logging.Logger       # 插件专属日志器
    app: _AppContext             # 应用上下文

    def state(self, name: str = "state") -> StateStore:
        """获取插件专属持久化实例"""

def plugin(name: str) -> PluginContext:
    """
    Args:
        name: 插件名

    Returns:
        PluginContext，home 为 plugins/{name}/，
        state() 默认路径为 plugins/{name}/state.json，
        app.store() 默认路径为 state/plugins.state.json，
        logger 写入 plugins/{name}/{name}.log
    """

from byksdk import plugin

ctx = plugin("server")
ctx.state()              # plugins/server/state.json
ctx.state("config")      # plugins/server/config.json
ctx.app.store()          # state/plugins.state.json
ctx.app.store("shared")  # state/shared.json

class StateStore:
    path: Path                     # 数据文件路径

    def load(self) -> dict         # 读取全部数据
    def save(self, data) -> dict   # 覆盖保存，返回保存后的数据
    def get(self, key, default)    # 获取单个值，key 不存在返回 default
    def set(self, key, value)      # 设置单个值，返回完整数据
    def update(self, values)       # 批量更新，返回更新后的数据
    def delete(self, key)          # 删除单个值，返回剩余数据
    def clear(self)                # 清空所有数据，返回空字典