# -*- coding: utf-8 -*-
# Copyright (c) 2025 relakkes@gmail.com
#
# This file is part of MediaCrawler project.
# Repository: https://github.com/NanmiCoder/MediaCrawler/blob/main/api/schemas/settings.py
# GitHub: https://github.com/NanmiCoder
# Licensed under NON-COMMERCIAL LEARNING LICENSE 1.1
#
# 声明：本代码仅供学习和研究目的使用。使用者应遵守以下原则：
# 1. 不得用于任何商业用途。
# 2. 使用时应遵守目标平台的使用条款和robots.txt规则。
# 3. 不得进行大规模爬取或对平台造成运营干扰。
# 4. 应合理控制请求频率，避免给目标平台带来不必要的负担。
# 5. 不得用于任何非法或不当的用途。
#
# 详细许可条款请参阅项目根目录下的LICENSE文件。
# 使用本代码即表示您同意遵守上述原则和LICENSE中的所有条款。

"""Request model for the settings endpoint."""

from typing import Any, Dict

from pydantic import BaseModel, ConfigDict


class SettingsUpdatePayload(BaseModel):
    """Partial update of arbitrary setting keys.

    Fields are not declared here on purpose: ``api/monitor/app_settings.py``
    owns the registry (key, type, bounds, choices) and validates against it, so
    adding a setting does not mean editing a matching schema.
    """

    model_config = ConfigDict(extra="allow")

    def values(self) -> Dict[str, Any]:
        return dict(self.model_extra or {})