Merge remote-tracking branch 'origin/master' into fix/docs-update-and-dropped-support-3.8

# Conflicts:
#	.github/workflows/python-app.yml
#	README.md
#	poetry.lock
#	pyproject.toml

Author: p1p1daster

.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - dependencies

.github/renovate.json

@@ -3,19 +3,31 @@
     UnsupportedBotAPIVersionError,
 )
 from pybotx.bot.api.responses.bot_disabled import (
+    BotAPIBotDisabledErrorData,
     BotAPIBotDisabledResponse,
     build_bot_disabled_response,
 )
 from pybotx.bot.api.responses.command_accepted import build_command_accepted_response
+from pybotx.bot.api.responses.unverified_request import (
+    BotAPIUnverifiedRequestErrorData,
+    BotAPIUnverifiedRequestResponse,
+    build_unverified_request_response,
+)
 from pybotx.bot.bot import Bot
 from pybotx.bot.callbacks.callback_repo_proto import CallbackRepoProto
 from pybotx.bot.exceptions import (
     AnswerDestinationLookupError,
     BotShuttingDownError,
     BotXMethodCallbackNotFoundError,
+    RequestHeadersNotProvidedError,
     UnknownBotAccountError,
+    UnverifiedRequestError,
+)
+from pybotx.bot.handler import (
+    IncomingMessageHandlerFunc,
+    Middleware,
+    SyncSmartAppEventHandlerFunc,
 )
-from pybotx.bot.handler import IncomingMessageHandlerFunc, Middleware
 from pybotx.bot.handler_collector import HandlerCollector
 from pybotx.bot.testing import lifespan_wrapper
 from pybotx.client.exceptions.callbacks import (
@@ -40,12 +52,22 @@
     InvalidBotXResponsePayloadError,
     InvalidBotXStatusCodeError,
 )
+from pybotx.client.exceptions.message import MessageNotFoundError
 from pybotx.client.exceptions.notifications import (
     BotIsNotChatMemberError,
     FinalRecipientsListEmptyError,
     StealthModeDisabledError,
 )
 from pybotx.client.exceptions.users import UserNotFoundError
+from pybotx.client.smartapps_api.exceptions import SyncSmartAppEventHandlerNotFoundError
+from pybotx.client.smartapps_api.smartapp_manifest import (
+    SmartappManifest,
+    SmartappManifestAndroidParams,
+    SmartappManifestAuroraParams,
+    SmartappManifestIosParams,
+    SmartappManifestUnreadCounterParams,
+    SmartappManifestWebParams,
+)
 from pybotx.client.stickers_api.exceptions import (
     InvalidEmojiError,
     InvalidImageError,
@@ -61,13 +83,15 @@
     OutgoingAttachment,
 )
 from pybotx.models.bot_account import BotAccount, BotAccountWithSecret
+from pybotx.models.bot_catalog import BotsListItem
 from pybotx.models.bot_sender import BotSender
 from pybotx.models.chats import Chat, ChatInfo, ChatInfoMember, ChatListItem
 from pybotx.models.enums import (
     AttachmentTypes,
     ChatTypes,
     ClientPlatforms,
     MentionTypes,
+    SmartappManifestWebLayoutChoices,
     SyncSourceTypes,
     UserKinds,
 )
@@ -103,11 +127,18 @@
 from pybotx.models.smartapps import SmartApp
 from pybotx.models.status import BotMenu, StatusRecipient
 from pybotx.models.stickers import Sticker, StickerPack
+from pybotx.models.sync_smartapp_event import (
+    BotAPISyncSmartAppEventErrorResponse,
+    BotAPISyncSmartAppEventResponse,
+    BotAPISyncSmartAppEventResultResponse,
+)
 from pybotx.models.system_events.added_to_chat import AddedToChatEvent
 from pybotx.models.system_events.chat_created import ChatCreatedEvent, ChatCreatedMember
+from pybotx.models.system_events.chat_deleted_by_user import ChatDeletedByUserEvent
 from pybotx.models.system_events.cts_login import CTSLoginEvent
 from pybotx.models.system_events.cts_logout import CTSLogoutEvent
 from pybotx.models.system_events.deleted_from_chat import DeletedFromChatEvent
+from pybotx.models.system_events.event_edit import EventEdit
 from pybotx.models.system_events.internal_bot_notification import (
     InternalBotNotificationEvent,
 )
@@ -118,14 +149,20 @@
 __all__ = (
     "AddedToChatEvent",
     "AnswerDestinationLookupError",
-    "AttachmentTypes",
     "AttachmentDocument",
     "AttachmentImage",
-    "AttachmentVoice",
+    "AttachmentTypes",
     "AttachmentVideo",
+    "AttachmentVoice",
     "Bot",
+    "BotAPIBotDisabledErrorData",
     "BotAPIBotDisabledResponse",
     "BotAPIMethodFailedCallback",
+    "BotAPISyncSmartAppEventErrorResponse",
+    "BotAPISyncSmartAppEventResponse",
+    "BotAPISyncSmartAppEventResultResponse",
+    "BotAPIUnverifiedRequestErrorData",
+    "BotAPIUnverifiedRequestResponse",
     "BotAccount",
     "BotAccountWithSecret",
     "BotIsNotChatMemberError",
@@ -134,6 +171,7 @@
     "BotShuttingDownError",
     "BotXMethodCallbackNotFoundError",
     "BotXMethodFailedCallbackReceivedError",
+    "BotsListItem",
     "BubbleMarkup",
     "Button",
     "ButtonRow",
@@ -148,6 +186,7 @@
     "ChatCreatedMember",
     "ChatCreationError",
     "ChatCreationProhibitedError",
+    "ChatDeletedByUserEvent",
     "ChatInfo",
     "ChatInfoMember",
     "ChatListItem",
@@ -157,6 +196,7 @@
     "DeletedFromChatEvent",
     "Document",
     "EditMessage",
+    "EventEdit",
     "EventNotFoundError",
     "File",
     "FileDeletedError",
@@ -185,6 +225,7 @@
     "MentionList",
     "MentionTypes",
     "MentionUser",
+    "MessageNotFoundError",
     "MessageStatus",
     "Middleware",
     "OutgoingAttachment",
@@ -193,18 +234,28 @@
     "RateLimitReachedError",
     "Reply",
     "ReplyMessage",
+    "RequestHeadersNotProvidedError",
     "SmartApp",
     "SmartAppEvent",
-    "SmartAppEvent",
+    "SmartappManifest",
+    "SmartappManifestAndroidParams",
+    "SmartappManifestAuroraParams",
+    "SmartappManifestIosParams",
+    "SmartappManifestUnreadCounterParams",
+    "SmartappManifestWebLayoutChoices",
+    "SmartappManifestWebParams",
     "StatusRecipient",
     "StealthModeDisabledError",
     "Sticker",
     "StickerPack",
     "StickerPackOrStickerNotFoundError",
+    "SyncSmartAppEventHandlerFunc",
+    "SyncSmartAppEventHandlerNotFoundError",
     "SyncSourceTypes",
     "UnknownBotAccountError",
     "UnknownSystemEventError",
     "UnsupportedBotAPIVersionError",
+    "UnverifiedRequestError",
     "UserDevice",
     "UserFromCSV",
     "UserFromSearch",
@@ -215,6 +266,7 @@
     "Voice",
     "build_bot_disabled_response",
     "build_command_accepted_response",
+    "build_unverified_request_response",
     "lifespan_wrapper",
 )
 

pybotx/__init__.py

@@ -20,11 +20,6 @@ async def write(self, content: bytes) -> int:
         ...  # noqa: WPS428
 
 
-class AsyncBufferUnicodeWritable(AsyncBufferBase):
-    async def write(self, content: str) -> int:
-        ...  # noqa: WPS428
-
-
 class AsyncBufferReadable(AsyncBufferBase):
     async def read(self, bytes_to_read: Optional[int] = None) -> bytes:
         ...  # noqa: WPS428

pybotx/async_buffer.py

@@ -23,7 +23,7 @@ class BotAPIBotDisabledResponse:
 def build_bot_disabled_response(status_message: str) -> Dict[str, Any]:
     """Build bot disabled response for BotX.
 
-    It should be send if the bot can't process the command.
+    It should be sent if the bot can't process the command.
     If you would like to build complex response, see `BotAPIBotDisabledResponse`.
 
     :param status_message: Status message.

pybotx/bot/api/responses/bot_disabled.py

@@ -0,0 +1,39 @@
+from dataclasses import asdict, dataclass, field
+from typing import Any, Dict, List, Literal
+
+
+@dataclass
+class BotAPIUnverifiedRequestErrorData:
+    status_message: str
+
+
+@dataclass
+class BotAPIUnverifiedRequestResponse:
+    """`Unverified request` response model.
+
+    Only `.error_data.status_message` attribute will be displayed to
+    user. Other attributes will be visible only in BotX logs.
+    """
+
+    error_data: BotAPIUnverifiedRequestErrorData
+    errors: List[str] = field(default_factory=list)
+    reason: Literal["unverified_request"] = "unverified_request"
+
+
+def build_unverified_request_response(status_message: str) -> Dict[str, Any]:
+    """Build `unverified request` response for BotX.
+
+    It should be sent if the header with the authorization token is missing or
+    the authorization token is invalid.
+    If you would like to build complex response, see `BotAPIUnverifiedRequestResponse`.
+
+    :param status_message: Status message.
+
+    :return: Built `unverified request` response.
+    """
+
+    response = BotAPIUnverifiedRequestResponse(
+        error_data=BotAPIUnverifiedRequestErrorData(status_message=status_message),
+    )
+
+    return asdict(response)