24024
af7c11d7f9
- 新增图像生成接口，支持试用、积分和自定义API Key模式 - 实现生成图片结果异步上传至MinIO存储，带重试机制 - 优化积分预扣除和异常退还逻辑，保障用户积分准确 - 添加获取生成历史记录接口，支持时间范围和分页 - 提供本地字典配置接口，支持模型、比例、提示模板和尺寸 - 实现图片批量上传接口，支持S3兼容对象存储 feat(admin): 增加管理员角色管理与权限分配接口 - 实现角色列表查询、角色创建、更新及删除功能 - 增加权限列表查询接口 - 实现用户角色分配接口，便于统一管理用户权限 - 增加系统字典增删查改接口，支持分类过滤和排序 - 权限控制全面覆盖管理接口，保证安全访问 feat(auth): 完善用户登录注册及权限相关接口与页面 - 实现手机号验证码发送及校验功能，保障注册安全 - 支持手机号注册、登录及退出接口，集成日志记录 - 增加修改密码功能，验证原密码后更新 - 提供动态导航菜单接口，基于权限展示不同菜单 - 实现管理界面路由及日志、角色、字典管理页面访问权限控制 - 添加系统日志查询接口，支持关键词和等级筛选 feat(app): 初始化Flask应用并配置蓝图与数据库 - 创建应用程序工厂，加载配置，初始化数据库和Redis客户端 - 注册认证、API及管理员蓝图，整合路由 - 根路由渲染主页模板 - 应用上下文中自动创建数据库表，保证运行环境准备完毕 feat(database): 提供数据库创建与迁移支持脚本 - 新增数据库创建脚本，支持自动检测是否已存在 - 添加数据库表初始化脚本，支持创建和删除所有表 - 实现RBAC权限初始化，包含基础权限和角色创建 - 新增字段手动修复脚本，添加用户API Key和积分字段 - 强制迁移脚本支持清理连接和修复表结构，初始化默认数据及角色分配 feat(config): 新增系统配置参数 - 配置数据库、Redis、Session和MinIO相关参数 - 添加AI接口地址及试用Key配置 - 集成阿里云短信服务配置及开发模式相关参数 feat(extensions): 初始化数据库、Redis和MinIO客户端 - 创建全局SQLAlchemy数据库实例和Redis客户端 - 配置基于boto3的MinIO兼容S3客户端 chore(logs): 添加示例系统日志文件 - 记录用户请求、验证码发送成功与失败的日志信息
390 lines
11 KiB
Python
390 lines
11 KiB
Python
import enum
|
|
import sys
|
|
|
|
from typing import (
|
|
Any,
|
|
Callable,
|
|
Generic,
|
|
Literal,
|
|
Mapping,
|
|
Protocol,
|
|
Sequence,
|
|
TypeVar,
|
|
overload,
|
|
)
|
|
|
|
# `import X as X` is required to make these public
|
|
from . import converters as converters
|
|
from . import exceptions as exceptions
|
|
from . import filters as filters
|
|
from . import setters as setters
|
|
from . import validators as validators
|
|
from ._cmp import cmp_using as cmp_using
|
|
from ._typing_compat import AttrsInstance_
|
|
from ._version_info import VersionInfo
|
|
from attrs import (
|
|
define as define,
|
|
field as field,
|
|
mutable as mutable,
|
|
frozen as frozen,
|
|
_EqOrderType,
|
|
_ValidatorType,
|
|
_ConverterType,
|
|
_ReprArgType,
|
|
_OnSetAttrType,
|
|
_OnSetAttrArgType,
|
|
_FieldTransformer,
|
|
_ValidatorArgType,
|
|
)
|
|
|
|
if sys.version_info >= (3, 10):
|
|
from typing import TypeGuard, TypeAlias
|
|
else:
|
|
from typing_extensions import TypeGuard, TypeAlias
|
|
|
|
if sys.version_info >= (3, 11):
|
|
from typing import dataclass_transform
|
|
else:
|
|
from typing_extensions import dataclass_transform
|
|
|
|
__version__: str
|
|
__version_info__: VersionInfo
|
|
__title__: str
|
|
__description__: str
|
|
__url__: str
|
|
__uri__: str
|
|
__author__: str
|
|
__email__: str
|
|
__license__: str
|
|
__copyright__: str
|
|
|
|
_T = TypeVar("_T")
|
|
_C = TypeVar("_C", bound=type)
|
|
|
|
_FilterType = Callable[["Attribute[_T]", _T], bool]
|
|
|
|
# We subclass this here to keep the protocol's qualified name clean.
|
|
class AttrsInstance(AttrsInstance_, Protocol):
|
|
pass
|
|
|
|
_A = TypeVar("_A", bound=type[AttrsInstance])
|
|
|
|
class _Nothing(enum.Enum):
|
|
NOTHING = enum.auto()
|
|
|
|
NOTHING = _Nothing.NOTHING
|
|
NothingType: TypeAlias = Literal[_Nothing.NOTHING]
|
|
|
|
# NOTE: Factory lies about its return type to make this possible:
|
|
# `x: List[int] # = Factory(list)`
|
|
# Work around mypy issue #4554 in the common case by using an overload.
|
|
|
|
@overload
|
|
def Factory(factory: Callable[[], _T]) -> _T: ...
|
|
@overload
|
|
def Factory(
|
|
factory: Callable[[Any], _T],
|
|
takes_self: Literal[True],
|
|
) -> _T: ...
|
|
@overload
|
|
def Factory(
|
|
factory: Callable[[], _T],
|
|
takes_self: Literal[False],
|
|
) -> _T: ...
|
|
|
|
In = TypeVar("In")
|
|
Out = TypeVar("Out")
|
|
|
|
class Converter(Generic[In, Out]):
|
|
@overload
|
|
def __init__(self, converter: Callable[[In], Out]) -> None: ...
|
|
@overload
|
|
def __init__(
|
|
self,
|
|
converter: Callable[[In, AttrsInstance, Attribute], Out],
|
|
*,
|
|
takes_self: Literal[True],
|
|
takes_field: Literal[True],
|
|
) -> None: ...
|
|
@overload
|
|
def __init__(
|
|
self,
|
|
converter: Callable[[In, Attribute], Out],
|
|
*,
|
|
takes_field: Literal[True],
|
|
) -> None: ...
|
|
@overload
|
|
def __init__(
|
|
self,
|
|
converter: Callable[[In, AttrsInstance], Out],
|
|
*,
|
|
takes_self: Literal[True],
|
|
) -> None: ...
|
|
|
|
class Attribute(Generic[_T]):
|
|
name: str
|
|
default: _T | None
|
|
validator: _ValidatorType[_T] | None
|
|
repr: _ReprArgType
|
|
cmp: _EqOrderType
|
|
eq: _EqOrderType
|
|
order: _EqOrderType
|
|
hash: bool | None
|
|
init: bool
|
|
converter: Converter | None
|
|
metadata: dict[Any, Any]
|
|
type: type[_T] | None
|
|
kw_only: bool
|
|
on_setattr: _OnSetAttrType
|
|
alias: str | None
|
|
|
|
def evolve(self, **changes: Any) -> "Attribute[Any]": ...
|
|
|
|
# NOTE: We had several choices for the annotation to use for type arg:
|
|
# 1) Type[_T]
|
|
# - Pros: Handles simple cases correctly
|
|
# - Cons: Might produce less informative errors in the case of conflicting
|
|
# TypeVars e.g. `attr.ib(default='bad', type=int)`
|
|
# 2) Callable[..., _T]
|
|
# - Pros: Better error messages than #1 for conflicting TypeVars
|
|
# - Cons: Terrible error messages for validator checks.
|
|
# e.g. attr.ib(type=int, validator=validate_str)
|
|
# -> error: Cannot infer function type argument
|
|
# 3) type (and do all of the work in the mypy plugin)
|
|
# - Pros: Simple here, and we could customize the plugin with our own errors.
|
|
# - Cons: Would need to write mypy plugin code to handle all the cases.
|
|
# We chose option #1.
|
|
|
|
# `attr` lies about its return type to make the following possible:
|
|
# attr() -> Any
|
|
# attr(8) -> int
|
|
# attr(validator=<some callable>) -> Whatever the callable expects.
|
|
# This makes this type of assignments possible:
|
|
# x: int = attr(8)
|
|
#
|
|
# This form catches explicit None or no default but with no other arguments
|
|
# returns Any.
|
|
@overload
|
|
def attrib(
|
|
default: None = ...,
|
|
validator: None = ...,
|
|
repr: _ReprArgType = ...,
|
|
cmp: _EqOrderType | None = ...,
|
|
hash: bool | None = ...,
|
|
init: bool = ...,
|
|
metadata: Mapping[Any, Any] | None = ...,
|
|
type: None = ...,
|
|
converter: None = ...,
|
|
factory: None = ...,
|
|
kw_only: bool | None = ...,
|
|
eq: _EqOrderType | None = ...,
|
|
order: _EqOrderType | None = ...,
|
|
on_setattr: _OnSetAttrArgType | None = ...,
|
|
alias: str | None = ...,
|
|
) -> Any: ...
|
|
|
|
# This form catches an explicit None or no default and infers the type from the
|
|
# other arguments.
|
|
@overload
|
|
def attrib(
|
|
default: None = ...,
|
|
validator: _ValidatorArgType[_T] | None = ...,
|
|
repr: _ReprArgType = ...,
|
|
cmp: _EqOrderType | None = ...,
|
|
hash: bool | None = ...,
|
|
init: bool = ...,
|
|
metadata: Mapping[Any, Any] | None = ...,
|
|
type: type[_T] | None = ...,
|
|
converter: _ConverterType
|
|
| list[_ConverterType]
|
|
| tuple[_ConverterType]
|
|
| None = ...,
|
|
factory: Callable[[], _T] | None = ...,
|
|
kw_only: bool | None = ...,
|
|
eq: _EqOrderType | None = ...,
|
|
order: _EqOrderType | None = ...,
|
|
on_setattr: _OnSetAttrArgType | None = ...,
|
|
alias: str | None = ...,
|
|
) -> _T: ...
|
|
|
|
# This form catches an explicit default argument.
|
|
@overload
|
|
def attrib(
|
|
default: _T,
|
|
validator: _ValidatorArgType[_T] | None = ...,
|
|
repr: _ReprArgType = ...,
|
|
cmp: _EqOrderType | None = ...,
|
|
hash: bool | None = ...,
|
|
init: bool = ...,
|
|
metadata: Mapping[Any, Any] | None = ...,
|
|
type: type[_T] | None = ...,
|
|
converter: _ConverterType
|
|
| list[_ConverterType]
|
|
| tuple[_ConverterType]
|
|
| None = ...,
|
|
factory: Callable[[], _T] | None = ...,
|
|
kw_only: bool | None = ...,
|
|
eq: _EqOrderType | None = ...,
|
|
order: _EqOrderType | None = ...,
|
|
on_setattr: _OnSetAttrArgType | None = ...,
|
|
alias: str | None = ...,
|
|
) -> _T: ...
|
|
|
|
# This form covers type=non-Type: e.g. forward references (str), Any
|
|
@overload
|
|
def attrib(
|
|
default: _T | None = ...,
|
|
validator: _ValidatorArgType[_T] | None = ...,
|
|
repr: _ReprArgType = ...,
|
|
cmp: _EqOrderType | None = ...,
|
|
hash: bool | None = ...,
|
|
init: bool = ...,
|
|
metadata: Mapping[Any, Any] | None = ...,
|
|
type: object = ...,
|
|
converter: _ConverterType
|
|
| list[_ConverterType]
|
|
| tuple[_ConverterType]
|
|
| None = ...,
|
|
factory: Callable[[], _T] | None = ...,
|
|
kw_only: bool | None = ...,
|
|
eq: _EqOrderType | None = ...,
|
|
order: _EqOrderType | None = ...,
|
|
on_setattr: _OnSetAttrArgType | None = ...,
|
|
alias: str | None = ...,
|
|
) -> Any: ...
|
|
@overload
|
|
@dataclass_transform(order_default=True, field_specifiers=(attrib, field))
|
|
def attrs(
|
|
maybe_cls: _C,
|
|
these: dict[str, Any] | None = ...,
|
|
repr_ns: str | None = ...,
|
|
repr: bool = ...,
|
|
cmp: _EqOrderType | None = ...,
|
|
hash: bool | None = ...,
|
|
init: bool = ...,
|
|
slots: bool = ...,
|
|
frozen: bool = ...,
|
|
weakref_slot: bool = ...,
|
|
str: bool = ...,
|
|
auto_attribs: bool = ...,
|
|
kw_only: bool = ...,
|
|
cache_hash: bool = ...,
|
|
auto_exc: bool = ...,
|
|
eq: _EqOrderType | None = ...,
|
|
order: _EqOrderType | None = ...,
|
|
auto_detect: bool = ...,
|
|
collect_by_mro: bool = ...,
|
|
getstate_setstate: bool | None = ...,
|
|
on_setattr: _OnSetAttrArgType | None = ...,
|
|
field_transformer: _FieldTransformer | None = ...,
|
|
match_args: bool = ...,
|
|
unsafe_hash: bool | None = ...,
|
|
) -> _C: ...
|
|
@overload
|
|
@dataclass_transform(order_default=True, field_specifiers=(attrib, field))
|
|
def attrs(
|
|
maybe_cls: None = ...,
|
|
these: dict[str, Any] | None = ...,
|
|
repr_ns: str | None = ...,
|
|
repr: bool = ...,
|
|
cmp: _EqOrderType | None = ...,
|
|
hash: bool | None = ...,
|
|
init: bool = ...,
|
|
slots: bool = ...,
|
|
frozen: bool = ...,
|
|
weakref_slot: bool = ...,
|
|
str: bool = ...,
|
|
auto_attribs: bool = ...,
|
|
kw_only: bool = ...,
|
|
cache_hash: bool = ...,
|
|
auto_exc: bool = ...,
|
|
eq: _EqOrderType | None = ...,
|
|
order: _EqOrderType | None = ...,
|
|
auto_detect: bool = ...,
|
|
collect_by_mro: bool = ...,
|
|
getstate_setstate: bool | None = ...,
|
|
on_setattr: _OnSetAttrArgType | None = ...,
|
|
field_transformer: _FieldTransformer | None = ...,
|
|
match_args: bool = ...,
|
|
unsafe_hash: bool | None = ...,
|
|
) -> Callable[[_C], _C]: ...
|
|
def fields(cls: type[AttrsInstance]) -> Any: ...
|
|
def fields_dict(cls: type[AttrsInstance]) -> dict[str, Attribute[Any]]: ...
|
|
def validate(inst: AttrsInstance) -> None: ...
|
|
def resolve_types(
|
|
cls: _A,
|
|
globalns: dict[str, Any] | None = ...,
|
|
localns: dict[str, Any] | None = ...,
|
|
attribs: list[Attribute[Any]] | None = ...,
|
|
include_extras: bool = ...,
|
|
) -> _A: ...
|
|
|
|
# TODO: add support for returning a proper attrs class from the mypy plugin
|
|
# we use Any instead of _CountingAttr so that e.g. `make_class('Foo',
|
|
# [attr.ib()])` is valid
|
|
def make_class(
|
|
name: str,
|
|
attrs: list[str] | tuple[str, ...] | dict[str, Any],
|
|
bases: tuple[type, ...] = ...,
|
|
class_body: dict[str, Any] | None = ...,
|
|
repr_ns: str | None = ...,
|
|
repr: bool = ...,
|
|
cmp: _EqOrderType | None = ...,
|
|
hash: bool | None = ...,
|
|
init: bool = ...,
|
|
slots: bool = ...,
|
|
frozen: bool = ...,
|
|
weakref_slot: bool = ...,
|
|
str: bool = ...,
|
|
auto_attribs: bool = ...,
|
|
kw_only: bool = ...,
|
|
cache_hash: bool = ...,
|
|
auto_exc: bool = ...,
|
|
eq: _EqOrderType | None = ...,
|
|
order: _EqOrderType | None = ...,
|
|
collect_by_mro: bool = ...,
|
|
on_setattr: _OnSetAttrArgType | None = ...,
|
|
field_transformer: _FieldTransformer | None = ...,
|
|
) -> type: ...
|
|
|
|
# _funcs --
|
|
|
|
# TODO: add support for returning TypedDict from the mypy plugin
|
|
# FIXME: asdict/astuple do not honor their factory args. Waiting on one of
|
|
# these:
|
|
# https://github.com/python/mypy/issues/4236
|
|
# https://github.com/python/typing/issues/253
|
|
# XXX: remember to fix attrs.asdict/astuple too!
|
|
def asdict(
|
|
inst: AttrsInstance,
|
|
recurse: bool = ...,
|
|
filter: _FilterType[Any] | None = ...,
|
|
dict_factory: type[Mapping[Any, Any]] = ...,
|
|
retain_collection_types: bool = ...,
|
|
value_serializer: Callable[[type, Attribute[Any], Any], Any] | None = ...,
|
|
tuple_keys: bool | None = ...,
|
|
) -> dict[str, Any]: ...
|
|
|
|
# TODO: add support for returning NamedTuple from the mypy plugin
|
|
def astuple(
|
|
inst: AttrsInstance,
|
|
recurse: bool = ...,
|
|
filter: _FilterType[Any] | None = ...,
|
|
tuple_factory: type[Sequence[Any]] = ...,
|
|
retain_collection_types: bool = ...,
|
|
) -> tuple[Any, ...]: ...
|
|
def has(cls: type) -> TypeGuard[type[AttrsInstance]]: ...
|
|
def assoc(inst: _T, **changes: Any) -> _T: ...
|
|
def evolve(inst: _T, **changes: Any) -> _T: ...
|
|
|
|
# _config --
|
|
|
|
def set_run_validators(run: bool) -> None: ...
|
|
def get_run_validators() -> bool: ...
|
|
|
|
# aliases --
|
|
|
|
s = attributes = attrs
|
|
ib = attr = attrib
|
|
dataclass = attrs # Technically, partial(attrs, auto_attribs=True) ;)
|