mirror of
https://github.com/aiogram/aiogram.git
synced 2026-04-08 16:37:47 +00:00
4008a3114d
Upgrade architecture + 5.0 Bot API (#469) * Moved `methods`, `types` and `client` to root package * Removed update handler from routers to dispatcher * Reworked events propagation mechanism to handlers * Reworked inner middlewares logic (very small change) * Updated to Bot API 5.0 * Initial migration from MkDocs to Sphinx + config for readthedocs
45 lines
2.7 KiB
Python
45 lines
2.7 KiB
Python
from __future__ import annotations
|
|
|
|
from typing import TYPE_CHECKING, Any, Dict, Optional, Union
|
|
|
|
from ..types import InputFile, MaskPosition
|
|
from .base import Request, TelegramMethod, prepare_file
|
|
|
|
if TYPE_CHECKING: # pragma: no cover
|
|
from ..client.bot import Bot
|
|
|
|
|
|
class CreateNewStickerSet(TelegramMethod[bool]):
|
|
"""
|
|
Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You **must** use exactly one of the fields *png_sticker* or *tgs_sticker*. Returns :code:`True` on success.
|
|
|
|
Source: https://core.telegram.org/bots/api#createnewstickerset
|
|
"""
|
|
|
|
__returning__ = bool
|
|
|
|
user_id: int
|
|
"""User identifier of created sticker set owner"""
|
|
name: str
|
|
"""Short name of sticker set, to be used in :code:`t.me/addstickers/` URLs (e.g., *animals*). Can contain only english letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in *'_by_<bot username>'*. *<bot_username>* is case insensitive. 1-64 characters."""
|
|
title: str
|
|
"""Sticker set title, 1-64 characters"""
|
|
emojis: str
|
|
"""One or more emoji corresponding to the sticker"""
|
|
png_sticker: Optional[Union[InputFile, str]] = None
|
|
"""**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More info on Sending Files » <sending-files>`"""
|
|
tgs_sticker: Optional[InputFile] = None
|
|
"""**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/animated_stickers#technical-requirements <https://core.telegram.org/animated_stickers#technical-requirements>`_`https://core.telegram.org/animated_stickers#technical-requirements <https://core.telegram.org/animated_stickers#technical-requirements>`_ for technical requirements"""
|
|
contains_masks: Optional[bool] = None
|
|
"""Pass :code:`True`, if a set of mask stickers should be created"""
|
|
mask_position: Optional[MaskPosition] = None
|
|
"""A JSON-serialized object for position where the mask should be placed on faces"""
|
|
|
|
def build_request(self, bot: Bot) -> Request:
|
|
data: Dict[str, Any] = self.dict(exclude={"png_sticker", "tgs_sticker"})
|
|
|
|
files: Dict[str, InputFile] = {}
|
|
prepare_file(data=data, files=files, name="png_sticker", value=self.png_sticker)
|
|
prepare_file(data=data, files=files, name="tgs_sticker", value=self.tgs_sticker)
|
|
|
|
return Request(method="createNewStickerSet", data=data, files=files)
|